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CHAPTER 1 


Introduction 





This chapter sets the context and the current mobile landscape. We start by introducing 
the overall architectural pattern and the definition of Continuous Integration (CI) and 
subsequently list the installation steps of the tools and software that form the platform. 
The underlying software platform (Jenkins, Nexus, SonarQube, and Docker, et al.) form 
the foundation on which we build automation concepts. 


Architecture 


In this book, I present a pattern for Cl,a.k.a. quick feedback as soon as the developer 
checks in the code. Although the term CI for some involves merging and building code 
in a distributed model, in this book, you will not only merge code, but also build, deploy, 
and test it. Only when you complete the loop of build-deploy-test (the key piece is testing) 
will you be confident about the quality of the code you checked in. 

You will start with a minimum viable product (MVP) that follows the architecture 
shown in Figure 1-1. All steps in the process are completely automated—no exceptions! 


© Pradeep Macharla 2017 1 
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Figure 1-1. Overall architecture 


As you reach initial maturity with the CI feedback loop and see continuous builds 
and feedback, you will continue to push the envelope and achieve parallel device testing. 
Figure 1-2 shows the Test Runner architecture. 


Test Runner 
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Figure 1-2. Test Runner architecture 


Prerequisites 


The following sections cover the software tools needed to follow the code patterns in this 


book. 


Windows vs. Mac 


To develop an Android app, you can use either Mac or Windows platforms. However, I 
recommend using Mac over Windows because of the following experiences I had: 


Device drivers are easier to obtain on a Mac (as opposed to 
Windows, where you have to identify the hardware and go to the 
vendor’s web site) 


System resources (CPU, RAM, etc.) perform better on a Mac 
The emulator performs relatively better on a Mac 
Most online examples refer to the Mac environment 


Android OS is a *nix core underneath, hence the experience of 
developing, debugging, and testing feels better on a Mac 


CHAPTER 1 ™ INTRODUCTION 


Note This book uses a Mac for the hardware and for the underlying OS. 


The Mac Environment 


The Mac environment shown in Figure 1-3 was used to run all the examples in this book. 


OS X Yosemite 


Version 10.10.5 


Mac mini (Late 2012) 

Processor 2.5 GHz Intel Core i5 

Momory 16 GB 1600 MHz DDR3 

Graphics Intel HD Graphics 4000 1024 MB 
Serial Number CO7MFSVGDWYL 


System Report... Software Update... 


Figure 1-3. Mac environment used for the book’s examples 


Mobile Devices 


You should have at least one real Android device. It’s best to have an Android 4.4 
Operating system or above, API 17 or above. With Android 4.2 and earlier, the appium 
server needs to be started with selendroid-port in addition to bootstrap-port. Details 
of port values are listed in Chapter 8, “Work with Appium’: 


Network 


It’s best if all the servers (Jenkins, Nexus, Sonar, Appium, etc.) and the build machine 
were in the same network segment. At a minimum, they should be able to ping (assuming 
ICMP is not disabled) and be able to reach each other on the ports that the processes 
listen (mostly TCP). (For example, if Jenkins were running on web 8080, you should be 
able to reach http: //jenkins_url:8080 from all other machines.) 
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Platform 


The following domain knowledge is required to a certain extent. 


Java programming language and runtime (the Android app source 
is in Java) 


Ruby programming language (understand the automation 
framework written with Cucumber and Ruby) 


Usage of *nix operating systems (the Mac aligns with *nix style) 


Programming Language 


The test automation framework uses the Ruby programming language. I chose Ruby with 
Gherkin, since it’s close to reading the English language. 


Installation Processes 


For each software program you need, the installation instructions are provided. At the 
end of each section, you'll find a link to a video demonstrating the installation process. 


Installing Jenkins 


The version of Jenkins installed at the time of writing this book is 1.642.1. 
Use the following steps to install Jenkins: 


1. 


Log in to a machine that has Docker installed on it 
(installation instructions for Docker, which are machine 
dependent, are found at https: //docs.docker.com/engine/ 
installation/). This example uses Ubuntu 14.04 OS. 


Run the command docker run -d -name “myjenkins" -p 
8083:8080 jenkins:latest (latest at the time of this writing 
is the 1.642.1 version of Jenkins). 


Access the Jenkins URL using http: //hostname: 8083. 


Navigate to Manage Jenkins > Manager Users. Add a user 
with the name admin and provide a password. 


Navigate to Manage Jenkins > Configure Global Security. 
Check the Enable Security checkbox. On the same page, 
under Access Control, select Jenkin’s Own User Database. 
Under Authorization, select Matrix-Based Security. 


Add a user called admin and check all the boxes in all the 
columns (for more detailed instructions, watch the video). 


Now save the page. This will focus the page to the user login. 
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8. Login as the admin user. 


9. Click New Item in the left menu, provide an Item Name of 
HelloWorld, and click OK. 


10. Goto Build > Add Build Step > Execute Shell. 
11. Inthe text area, type echo “hello world” and click Save. 
12. Click Build Now in the left menu. 


13. The build passes in and a blue ball shows up against the entry 
in Build History. 


14. If you want to see the console output, click the build number 
(#1) and then click Console Output. 


Jenkins is successfully installed now. Figure 1-4 shows the UI. 
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Figure 1-4. Jenkins UI 


The link to the video demonstrating the steps is https: //vimeo.com/154497273. 


Installing Nexus 


The version of Nexus installed at the time of writing this book is 2.11.4-01. 
Use the following steps to install Nexus: 


1. Login to your machine that has Docker installed on it 
(installation instructions for Docker, which are machine 
dependent, are found at https: //docs.docker.com/engine/ 
installation/). This example uses Ubuntu 14.04 OS. 


CHAPTER 1 ™ INTRODUCTION 


2. Run the command docker run -d -name “mynexus" -p 
8081:8081 sonatype/nexus:oss (the latest at the time of this 
writing is 2.11.4-01). 


3. Access the Nexus URL using http://localhost :8081 
(the default credentials are admin/admin123). 


Nexus is successfully installed now, and the UI is shown in Figure 1-5. 
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Figure 1-5. Nexus UI 


Check out https ://vimeo .com/154500108 to see how to install Nexus. 


Installing SonarQube 


The version of SonarQube installed at the time of writing this book is 5.1. 
Use the following steps to install SonarQube: 


1. Login to your machine that has Docker installed on it 
(installation instructions for Docker, which are machine 
dependent, are found at https: //docs.docker.com/engine/ 
installation/). This example uses Ubuntu 14.04 OS. 


2. Run the command docker run -d -name “mysonarqube" -p 
9000:9000 sonarqube:5.1 (the latest version at the time of 
writing is 5.1). 


3. Access the SonarQube URL using http: //localhost: 9000 
(the default credentials are admin/admin). 
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SonarQube is successfully installed now, and its UI is shown in Figure 1-6. 
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Figure 1-6. SonarQube UI 


Check out https ://vimeo.com/154499186 to see how to install SonarQube. 


Installing the CI Tool Stack 


Until now, you have installed the tools individually; however, there is another option to 
install all of them at once (if you prefer). This section is optional. 


1. Login to your machine that has Docker installed on it 
(installation instructions for Docker, which are machine 
dependent, are found at https ://docs .docker.com/engine/ 
installation/). This example uses Ubuntu 14.04 OS. 
Alternately, you can have docker-machine do all the work for 
you. 


2. Usethe check out code git clone https://github.com/ 
machzqcq/docker-ci-tool-stack. git. 


3. Run docker-compose up from the root of the folder. 


The table of tools listed in Figure 1-7 will be ready in a few seconds (not more than 
60 seconds). 


Tool Link Credentials 
Jenkins http://${docker-machine ip default}:18080/ no login required 
SonarQube http://${docker-machine ip default}:19000/ admin/admin 
Nexus http://${docker-machine ip default}:18081/nexus admin/admin123 
GitLab http://${docker-machine ip default}:10080/ root/5iveL!fe 


Selenium Grid _—_http://${docker-machine ip default}:4444/grid/console no login required 


Figure 1-7. CI tool stack endpoints 


Check out https: //vimeo.com/154935657 to see how to install the CI tool stack. 
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Building the Android App 


The build-deploy-test feedback loop starts with the build process. The video at 

https: //vimeo.com/154936765 quickly walks through the steps involved in building 
an Android app. The Android app you are building here is only for demonstrating how 
to build an app. In later chapters, when you get to test automation, you will start from 
the source code and walk through detailed steps to reach the build phase. 


Note Watching the video is not mandatory to move forward in the book, but it gives you 
a fast-forward view of the value-add from this book. You may conveniently skip this video 
and come back after completing the book. Chapter 5, “Build Android App,” has detailed 
instructions and steps if you prefer text instructions. 


Check out https: //vimeo.com/154936765 to see how to install the Android app. 


Deploying/Installing the Android App 


The deploy step in build-deploy-test is when the app becomes real and available to 
interact. The video quickly walks through the steps involved in building an Android app. 
The Android app you are deploying here is only for demonstrating how to build an app. 
In later chapters, when you get to test automation, you will start from the source code and 
walk through detailed steps to reach the deploy phase. 


Note Watching the video is not mandatory to move forward in the book, but it gives you 
a fast-forward view of the value-add from this book. You may conveniently skip this video 
and come back after completing the book. Chapter 7, “Deploy or Install Android App,” has 
detailed instructions and steps if you prefer text instructions. 


Check out https: //vimeo.com/155159581 to see how to deploy the Android app. 


Testing (Automating) the Android App 


The test step in the build-deploy-test feedback loop tells you whether the app meets the 
specifications and requirements. The test phase feedback is passed into the developer’s 
queue to improvise and/or fix bugs. The video fast-forwards the end-state solution when 
running the automated tests against the app. 
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Note Watching the video is not mandatory to move forward in the book, but it gives you 
a fast-forward view of the value-add from this book. You may conveniently skip this video and 
come back after completing the book. Chapter 8, “Working to Appium,” and Chapter 9, “Test 
Strategy and Execution,” include detailed instructions and steps if you prefer text instructions. 


Check out https: //www. youtube. com/watch?v=In9sCFrv-Do&feature=youtu. be to 
see how to test the Android app. 


Mobile Technologies 


Mobile involves hardware, software, platforms, apps, and the overall experience. You can 
also look at smart vs. other mobile devices. To put perspective on mobile technologies, 
some attributes that help filter the avalanche of information are listed next. 


What Do Consumers Want? 


See https: //info.dynatrace.com/rs/compuware/images/Mobile App Survey Report.pdf 
for a great read from Dynatrace. 


Ecosystems 


Much like how Microsoft, Redhat, Canonical, et al. represent ecosystems in the operating 
systems space, there are ecosystems that are present in the mobile apps domain too. 
Ecosystems are entry points into the platforms on which mobile applications are 
developed, maintained, delivered, and enhanced. 

At the time of writing this book, the ecosystems are broadly classified into the 
following categories. 


e Apple 
e Google 
e Windows 


Within each ecosystem, there can be many more categories, especially in the Google 
Android ecosystem (based on phone manufacturer, such as Huawei), as it provides more 
flexibility than Apple to tinker with the hardware architecture. 
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Hardware 


Here is a sampling of the hardware you will encounter when developing mobile apps: 


Apple 
Samsung 
Sony 
HTC 
Qualcom 
Motorola 
Huawei 
Lenovo 


LG 


You can read more at https://en.wikipedia.org/wiki/List_of best-selling _ 
mobile phones. 


Platforms/OS 


The four main platforms are: 


iOS 
Android 
Windows 


Firefox OS 


Types of Mobile Apps 


There are different types of mobile apps that meet various needs. The decision on the 
type of mobile app is based on multiple factors. Here are the types that exist at the time of 
writing this book (see Figure 1-8). 


Native apps: Mobile apps that are entirely developed using the 
tool stack available in the respective ecosystem (Apple, Google, 
Windows, etc.) are called native apps. The tool stack could mean 
the programming language, the SDK, the underlying platform, 
and so on. Native apps by far give the best user experience and 
performance. 
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e Web apps/HTML5 apps: Apps that use web technologies like 
HTMLS, JavaScript, and CSS that align with w3c standards are 
called web apps. Web apps do not heavily rely on native platform 
support and hence are more cross-platform and portable. That 
said, there is significant opportunity for improvement in the areas 
of secure local storage and access to device functionalities, like 
accelerometers, scanners, cameras, etc. 


e Hybrid apps: Hybrid, as the name suggests, takes the positives of 
both web and native apps and brings them together. 


NATIVE vs. WEB vs. HYBRID: 7 FACTORS OF COMPARISON KEY: CON PRO NEUTRAL 
NATIVE HYBRID WEB 
Commonly the highest of the three choices if Similar to pure web costs, but extra skills are Lowest cost due to single codebase and 
COST developing for multiple platforms required for hybrid tools common skillset 
CODE Code for one platform only works for that Most hybrid tools will enable portability of a Browser compatiblity and performance are 
REUSABILITY/ platform single codebase to the major mobile platforms the only concerns 
Many device APIs closed to web apps can be Only a few device APIs like the geolocation 
DEVICE ACCESS Platform SDK enables access to all device APis accessed, depending on the tools can be accessed, but the number is growing 
Platform comes with familiar, original UI UI frameworks can achieve a fairly native 
UI CONSISTENCY components UI frameworks can achieve a fairly native look look 
App stores provide marketing benefits, but App stores provide marketing benefits, but also No restrictions to launch, but there are no 
DISTRIBUTION also have requirements and restrictions have requirements and restrictions app store benefits 


Native code has direct access to platform For complex apps, the abstraction layers often Performance is based on browser and 
PERFORMANCE functionality, resulting In better performance prevent nativetike performance network connection 


More monetization opportunities, but stores More monetization opportunities, but stores No store commissions or setup costs, but 
MONETIZATION take a percentage take a percentage there are few monetization methods 





Figure 1-8. Comparing mobile app types 


You can read more at https: //dzone.com/articles/state-native-vs-web-vs- 
hybrid. This book covers native Android mobile apps. 
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Mobile Test Automation 





This chapter makes a case for mobile test automation and why it makes sense to invest 
in automation from the onset of your mobile app development process. The chapter also 
compares and contrasts the benefits of automation over manual testing practices. But 
first, you'll learn about a few evolutionary concepts, some of which are borrowed from 
web application test automation. 


The WebDriver Protocol 


WebDriver is a remote control interface that enables introspection and control of user 
agents. It provides a platform and language-neutral wire protocol as a way for out-of-process 
programs to remotely instruct the behavior of web browsers. A brief processing model is 
explained. 

The remote end (see https: //www.w3.org/TR/webdriver/#dfn-remote-end) is 
an HTTP server reading requests from the client and writing responses, typically over a 
TCP socket. For the purposes of this discussion, I model the data transmission between 
a particular local end and remote end with a connection to which the remote end may 
write and read bytes. 

After such a connection has been established, a remote end must run the 
following steps: 


1. Read bytes from the connection until an HTTP request can be 
constructed from the data. 


2. The HTTP request is matched with the request’s method and 
URL as parameters. 


3. Ifthe request match is of type error, send an error and error 
code, then return to Step 1. 


4. Letthe session ID be the corresponding variable from the URL 
variables. 


© Pradeep Macharla 2017 13 
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5. Ifthe command is New Session (and doesn’t match the 
existing session’s ID), then go back to Step 1. 


6. Execute the request and collect the response object. 


7. Send the response code and the results to the local end and 
return to Step 1. 


For further details on WebDriver Protocol, see https: //w3c.github.io/webdriver/ 
webdriver-spec.html. 

Selenium, the popular web test automation software, is based on the WebDriver 
protocol as its base layer. In fact, as you progress in the book, you will notice that the 
Appium communication also follows the WebDriver protocol. 


Why Are We Talking About These Protocols? 


Much like how micro-service APIs over monolithic applications are preferred in 
distributed systems, to take advantage of horizontal scaling, a similar innovation 

has happened in the past decade. Selenium (see https: //en.wikipedia. org/wiki/ 
Selenium (software), with its relatively lightweight architecture, is fast replacing many 
licensed and enterprise tools. 

There are web sites that have covered the web test automation use cases at 
http://www. seleniumframework.com/. 

Many mobile automation tools and frameworks adopt principles of web test 
automation tools. That means that understanding the history of web test automation 
tools helps you connect the evolution tools like Appium, Calabash, and other open source 
mobile automation tools. 


How Does It Work? 


The client library (the test automation scripts) communicates with an intermediary server, 
which in turn translates into commands understood by the browser. This eventually 
emulates an end user's actions on the browser (actually it operates on the DOM). 

See Figure 2-1. 
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Windows, Linux, or Mac (as appropriate)... 


Internet Explorer Firefox Safari 


Selenium Core Selenium Core Selenium Core 






lEDriverServer.exe 
SafariDriver 
Firefox has in-built driver 


. Machine boundary (optonal) SSS EEE EE EEE EEE EE EEE EEE EEE EEE EEE EEEEEEEEEEEEEEEEEE EE EEES 


Java, Ruby, 
Python, Peri, 
PHP or .Net 


Figure 2-1. Selenium WebDriver architecture 


So, as you can see in Figure 2-1, as long as you write automation scripts that the 
intermediary server can understand (WebDriver), the server takes care of translating 
them into actual commands that emulate user actions on the browser. 


How Does It Scale? 


In Figure 2-1, you can see that a single intermediary server (chromedriver.exe, Driver 
Server.exe) can maintain the session with an active browser and execute commands 
that you direct in the automation scripts. 

What if you want to execute tests in parallel? How about multiple instances of 
browsers on the same machine or on remote machines, and so on? 

To solve the problem of parallel execution and leverage horizontal scaling, the 
Selenium Grid came into existence. Its architecture is shown in Figure 2-2. 
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SELENIUM GRID 


+ Cross Browser Testing 

è Infrastructure and Automated 
Platform 

+ Manual Access 

e Automated Access 









HUB 
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Figure 2-2. The Selenium Grid 


A couple of noteworthy points: 


e The HUB is an HTTP server that listens on a port and redirects 
the requests to the appropriate Grid node (which maps to a 
WebDriver). 


e Since the communication happens on HTTP over TCP/IP, you can 
scale this model to the boundaries of the ports available on each 
machine in the control chain. 


e The HUB is the entry point and communication between HUB 
and nodes is purely over REST APIs (GET, POST, etc.) 


e The matching of a request from a client is done by the HUB based on 
the WebDriver protocol algorithm (a DesiredCapabilities object). 


How Does It Relate to Mobile Automation? 


Now, you can remotely execute commands on a browser as long as you have the 
intermediary server translating it to the right commands emulating user behavior. 

The same concept is applied to mobile test automation. The Appium server is like 
a ChromeDriver, [EDriverServer, or Safari driver, in that it can communicate with the UI 
Automation library for the Android or iOS ecosystems. 
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Internally, Appium knows how to talk to the UIAutomation library for Android. The 
UlIAutomation library will take commands from the Appium server and execute them on 
the app, which eventually translates to set, get, click, and all user actions. 

As the author of automation scripts, as long as you know how to identify elements 
(various locator/selector strategies; this space is quite mature now) and perform 
operations on those elements, the intended behavior is automated. 


Test Automation Libraries 


Over the past few years, the test automation tools that got some traction for Android 
apps included MonkeyTalk, Robotium, UiAutomator (uses UI Automation library), 
calabash-android, selendroid, Appium, etc. 

Android Espresso, a unit testing library that promises to do UI testing, is also 
relatively new as of writing this book. Let's wait and see how Expresso does; however, 
the fact that it is inside-out (unit testing) means that it might not cover the scope of 
integration testing (i.e., testing the exact path that an end user experiences). 

This book uses Appium as the test automation tool/framework because I found it 
aligned with my needs of testing native, web, and hybrid apps. It also follows the WebDriver 
protocol. You can read Appium's philosophy and competitive analysis with other tools and 
frameworks on its web site (http: //appium. io/introduction. html? lang=en). 

Some tradeoffs between Appium and Espresso are as follows: 


e Android Espresso is good because the tests are in the same 
language as the source code, which makes it easier to debug/ 
troubleshoot and fosters collaboration among the technical staff 
(the dev and test engineers). 


e Ifyou need access to the source code, executing the tests may work 
fine, but requires multiple vetting of build pipelines. CI 
(and hence testing from outside) gives relatively higher confidence 
before release. Appium is a better choice in this regard. 


e Use ATDD/BDD style because it lets lesser technical staff product 
owners/business stakeholders define “executable” acceptance 
criteria. This helps the three amigos (dev, test, and product) be on 
same page and fosters collaboration. 


e Availability of developer’s time, test coverage, etc., is also a 
tradeoff. Appium, with its support for most programming stacks, 
is a better choice in this regard. 


Why Automate? 


It should be a no-brainer why you automate processes. In fact, continuous 

integration and/or continuous delivery (see https: //martinfowler.com/bliki/ 
ContinuousDelivery.html) is not possible without automating the repeatable/mundane 
activities. Humans are not great compared to machines for computing repetitive tasks 
and performing all permutations and combinations on a certain problem. 
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That said, a human still has to architect and design the overall system, so should 
understand what a machine does and, more importantly, be able to troubleshoot when 
expected outcomes do not transpire. 

For the mobile app space, this article shows the costs associated with resubmitting 
a mobile app. The numbers are only suggestive; in fact, the costs might be higher than 
what is displayed in the table. The point is to say that the costs associated with defects/ 
bugs are very dear and include lost customers, countless developer hours, and brand 
image, to name a few. 


Mobile Test Strategy 


Software testers are familiar with writing test plans, test cases, and test release 
documents. A test strategy document is generally written by taking into account the 
application’s operating environment, the release cycle, test coverage, defect tracking, 
and overall a document that can be presented to executive management for approval 
of budget and timelines. Mobile test strategy aims to carve out the how, why, and what 
aspects that affect mobile testing. The following sections include are few considerations 
for creating a mobile test strategy. 


Manual Testing vs. Automation 


There are very rare scenarios in which the human eye does significantly better than an 
automated program when validating software, such as the aesthetics of a web site. That 
gap is also getting narrower by the day. AI (artificial intelligence) and ML (machine 
learning), for example, provide a much better ROI in the age of speed and continuous 
delivery. Visual test automation by tools like Applitools is a great example. This is not 
to say that we should make manual testing function redundant in an organization, 
rather it is to say that testing capabilities should include both automation and manual 
approaches, with a focus on automation. 

In the context of mobile testing, it is almost impossible for a human to manually test 
permutations and combinations across the dimensions of devices, SDKs, API levels, and 
ecosystems. Hence, your testing strategy should include (but not be limited to): 


e Automate early and often in the bottom-up order of the testing 
pyramid (see the “Test Pyramid” section later in this chapter). 


e Use BDD/TDD frameworks in the early stages when acceptance 
criteria are not clear and an automation script cannot be run 
(use mock frameworks to mitigate the absence of a real system). 


e Building and deploying an app should be self-serviced and 
automated without any exceptions. 


e Collaborate with other roles on the team and, in rare 
circumstances (such as during sprint demos), manually walk 
through workflows of the system (otherwise, the automation 
script should be run as a demo). 
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e The programming language should start with known, and tend 
toward the most collaborative. 


e Inside-out/outside-in (focus on end users). 

e Don’t boil the ocean—pick one and pivot. 

e Interoperability—cloud and on-premises infrastructures. 
e Tend toward using real devices. 


e Use Appium, Espresso, and XCTest. 


Speed of Testing 


High-speed testing is a mandatory requirement in the mobile space because a mobile 
app is successful in the market based on how fast it is delivered in the face of competition. 
There have been research studies suggesting that mobile users have an attention span of 
minutes before they uninstall an app. Releasing bug-free apps often is a make-or-break 
situation. 


Scaling 


Think of AWS and Netflix. The services can respond by scaling the systems based on load, 
performance, user traffic, and so on. While testing mobile apps, the testing capability 
should also be scalable across the three Vs (volume, variety, and velocity) with a tradeoff 
against cost. In the beginning of developing a project, it is advisable to rely on open 
source and cloud services before investing heavily on paid solutions. 


Cost 


Cost is a constraint in every decision you make when resources are required. Resources 
can be human, machine, time, etc. Hence, investing in open source solutions at the 
beginning is less risky because there is no vendor lock-in. It is a tradeoff decision because 
if you spend too much time on not-so-mature open source solutions, you might lose time. 
When it’s all said and done, open source solutions have come a long way and are mature 
in many ways. In fact, they are much more mature than some paid solutions in some 
cases. Your strategy should be to spend a week or two and scour the web for solutions and 
frameworks that are already built and use one as a starting point. 


Testing Pyramid 


The testing pyramid helps in terms of having conversations around how much and what 
priorities do different kinds of testing have in a project. See Figure 2-3. 
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Figure 2-3. The testing pyramid 


In the context of mobile testing (most mobile apps at the time of writing this book 
focus on the GUI layer), the pyramid can be read as follows: 


e The confidence while building the app (work-in-progress) is 
enhanced with more tests at the bottom of the pyramid. Hence, 
automated unit tests that execute successfully give confidence 
that the unit/component is a higher quality. 


e Since a software application is a network of components, 
integration points between the components become important as 
you race toward release to production. 


e Finally, the user experiences the GUI of the mobile app, hence 
from a user’s perspective, automated GUI tests give the highest 
confidence in quality. (For example, if a component at the lower 
layer breaks, the user’s experience will be felt at the GUI layer.) 


e The confidence in the overall system is enhanced by successfully 
running tests from lower to higher layers in the testing pyramid. 


e The testing pyramid also articulates the relative volume of tests to 
be written at various layers of the application. 


Further reading on the testing pyramid can be found at http://www. 
seleniumframework.com/decision-models/choose-automation-solution-2/. 
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Mobile Test Environment 


Mobile apps like web apps need an environment to run on. The environment is a function 
of hardware and software. To test a mobile app’s functionality, you need a mobile lab 

that can emulate a real-world scenario—i.e., a user operating on a mobile app and the 
workflows being executed. Mobile test environments can be complex to emulate, because 
the experience is controlled in a chain, and the individual links are owned by multiple 
entities. For example, the network bandwidth is controlled by the telecom providers, the 
software experience is controlled by Google and its Android partners, and so on. You'll 
explore the considerations that matter while interacting with a mobile test environment 
in the following sections. 


Real Devices vs. Emulators/Simulators 


One of the biggest challenges with mobile testing is device support. The number of 
models and the types of smartphones are increasing by the day and growing at an 
accelerating pace. There are differences between devices and which devices to test is not 
an easy challenge to solve. It is dependent on identifying the compatibility matrix as early 
as possible in the project, yet that becomes a challenge to collect as it is not static. 

However, you need to start narrowing it all down with an initial list. 

Emulators/simulators cannot emulate every feature of a real device—pixel perfect, 
phone hardware quirks, etc. In general, the software representation of underlying hardware 
in Android world is called an emulator (as opposed to a simulator in the iOS world). 

The test environment for mobile devices involves a mix of real devices and 
emulators/simulators to get the test coverage you expect—of course, the tradeoff is 
with cost. 


Initial Manual Testing on a Local Android Real Device 


In the case of a local Android device, use the following steps to experience the first build 
of an app. 
Android SDK installed on a Windows or Mac: 


1. Insure that the SDK is updated with the latest device drivers. 
For the Mac, my experience has been relatively easier 
with the device drivers; however, with Windows, I had to 
explicitly install the driver by going to the handset device 
manufacturer's web site. 


2. From the source code perspective, the attribute 
android: debuggable=true should be set. 


3. On the actual device, navigate to Settings > Developer Options 
> Enable USB Debugging and set that to True. If the setting is 
not found, navigate to Settings > About Phone and click Build 
Number seven times. That should bring up the option. 


21 


CHAPTER 2 ™ MOBILE TEST AUTOMATION 


4. Once the device is connected, a dialog box will appear on the 
device. Accept the message to allow communication. 


5. A quick verification step is to type adb devices from the 
terminal (the adb binary is located inside the SDK folder 
inside platform-tools directory). 


Initial Manual Testing on a Local Android Emulator 


Use the Android Virtual Device Manager to create various Android virtual devices with 
different devices, SDK versions, and many more hardware characteristics. 
Invoke the emulator as follows: 


e Navigate to Android SDK folder/tools/ to locate the emulator 
binary. 


e Theemulator -avd avd_name command invokes the previously 
created AVD. 


e [found it easier to first create an AVD configuration from IDE like 
Eclipse or IntelliJ, because the workflow is easier and the complex 
details are abstracted. 


Further Manual Testing in the Cloud 


You already know that it is almost impossible to have every device, hardware, and 
software and maintain a full-blown heterogeneous mobile test environment, as well as 
certify all devices and emulators for your mobile app. As you scale, you have to depend on 
cloud services. 


e Start using Sauce Labs. Sauce Labs natively supports Appium 
and that helps you be familiar with the tool for the next phase of 
automation. 


e Perfecto mobile is a fast growing service in terms of its coverage for 
mobile real devices and worth taking a look if you are an enterprise, 
as the cost vs. benefit analysis works well for large companies. 


e Amazon Device Lab has many options since early 2017 and 
the service is maturing with support for Appium and similar 
automation tools without leaving the context of Amazon Web 
Services Console. 


e Google Device Lab is a great option, if you are invested fully 
in Android mobile apps. The Google quality of experience is 
instantly realized, but bear in mind that the Google Cloud is 
slowly adding support for software automation frameworks like 
Appium and Calabash and would take a little bit more time as 
that is the not the core area they focused on. The purpose of 
Device Lab is to provide access to real devices in the cloud, not 
necessarily compete with Sauce Labs and Perfecto. 
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CHAPTER 3 


Cl Pattern with Jenkins 
and Android 





This chapter introduces architectural patterns and covers a specific continuous 
integration pattern that you will learn to implement in subsequent chapters. The chapter 
goes through high-level architecture images of the pattern to help you picture it mentally. 
As you progress through the chapter, you'll see the steps needed to configure the feedback 
loop(s) that help you model and implement the pattern. It is important to complete the 
tools installation described in Chapter 1 before starting this chapter. 


What Is Continuous Integration? 


Continuous integration (CI) is a development practice that requires developers to 
integrate code into a shared repository several times a day. Each check-in is then verified 
by an automated build, allowing teams to detect problems early. There are similar 
concepts, such as continuous deployment and continuous delivery. However, to keep 

this conversation simple, what I mean by continuous integration in this book involves 
integration of changes into the source code, building and deploying the binaries, and 
delivering the binaries to a target environment where end users can interact with the app. 


Feedback Loops 


As discussed in Chapter 1, feedback loops can be implemented using the Jenkins tool. 
Images are provided to give you an idea about each build step inside the Jenkins UI 
interface. 


Note | used Jenkins 1.642.1 version. If you installed a different version of Jenkins, 
make sure you select the free style job. The interface should be the same. 


© Pradeep Macharla 2017 23 
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Feedback Loop 1: Build 


Figure 3-1 shows the build feedback loop in the overall architecture diagram. This is 
where you build the app. 



















Cl Server ex die 
v Checkout code 
TEENY SONETON ¥ Code Quality Analysis 
ormipile, unit tests v More Steps lke lining 
Ee espe nie eae <" Tigger Acceptance Tests 
Trigger Code Quality Analysis 
: 1 
j Programmer 


<“ Deploy app 
x Smoke/Sanity Tests 
v Regression Tests 
v“ Feature Acceptance Tests 






Appium - i05 


Figure 3-1. The build feedback loop 


Based on the overall architecture, the first feedback loop does the following: 
1. Checks out the code. 
Applies (any) configuration. 


Compiles. 


2 

3 

4. Runs the unit tests (if any). 

5. Packages and uploads the code. 
6 


Triggers the code quality analysis. 
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Jenkins Job1 Configuration 


Figure 3-2 shows how a Jenkins Job is configured for the first feedback loop. 


Name the Jenkins job and specify the Log Rotation strategy. 





@ Jenkins 
ekin cingrade od 
$ Back to Deshteoand mabe ca anid 


i 
A Sais 


Balj àndod ipp 


T Changes 


[Workspace 

fe) Suto wan Parameters [Pian tect) Preview 
8 Dette Project Disan Cid Bulis 

yf. Contigure Sura Log Foramen 

Åj Warage Ounership Thy tor keap boidi 
ihe Job Config History 


Far 
Wia @ of huli bo beep 3 


(ot ber Conia 


Figure 3-2. The build job rotation 





Piadeen Mæ hara 


| lag aut 





Define an optional Boolean flag called UPLOAD to control the decision of uploading 
the build artifact to Nexus. The default value is unchecked. If you check it, then the build 


artifact gets uploaded to Nexus. See Figure 3-3. 


Docker Container 
GitHub project 


Notify when Job configuration changes 
yi This build is parameterized 
Boolean Parameter 
Name UPLOAD 
Default Value 


Description as if activated will upload files to Nexus for deploy 


## Not being used yet 


[Plain text) Preview 


Figure 3-3. The build Nexus flag 
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Enter the Nexus credentials to interact with Nexus; see Figure 3-4. 


configuration 
JUIN Pana 


heme NEXUS_USERNAME 


for 
Default Value jonkins 


Description 


(Pisin text] Preview 


Adi Parameter + 
Penmission to Copy Artifact 
Resinc! build axerulion causes 
Prepare: an environment for the nun 


Cesable Build (Wo new Builds will be toetud until thet prope) is re-enabled.) 





Execute cone umem builds if metered 


Figure 3-4. The build Nexus credentials 


Enter the GitHub repository URL representing the source code, as shown in Figure 3-5. 


Label is serviced by 1 node 


Advanced Project Options 


Source Code Managervent 


© Mane 
2 (v5 
CVS Propec teal 
= Ga 
Rieposiones 


Repository URL hitps:igithub com/machzge q aiaiai. «jt 


Čredentkats Facies 
j 





Branches to build Branch Specifier (blank for ary’) vrester 


Figure 3-5. The build source control 
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Check the boxes to delete the workspace before the build starts and to mask 
passwords, as shown in Figure 3-6. 


meobde.c: andro confrguralon 


Reposit wS 
epository browser (Auto) 


Additions ehav 
ddihonal Behaviours Add 


Subversion 


Build Triggers 


Trigger builds remotely (e.g . from scrpts) 


Build after other projects are built 
Build penocsc ally 
Build when a change is pushed to GitHub 
Poll SCM 
Build Environment 
~ Delete workspace before build starts 


Advanced. 





Figure 3-6. The build workspace and mask password checkboxes 


Set the Nexus password as shown in Figure 3-7, so that it can be masked. 


PF F hri ee 


= Waak pudaweeds (and enibe giota pisiwgda) 


Paseword Parameters, of any olhar type of build parameters selected for masking in Hudsons Jenkins man comigucation siren [Manage Hudson > Configure System), wil be zutomalically maskee 


tart WEXUS PASSWORD iiia en 
Add 


Provide Configuration files 
Abot thè beled if it's stuck 
Color ANSI Console ulpa 
Copy files into the jobs worcypace before buding 
Inpet'l aanne vanables to the bald proc asa 
Injett camerchip variables imo environment 
Inpeel paced bo the Dud oe arniran vanades 
Rosiori OS N keyehdine aia buld precise at defined in gotal configuranon 
SSH Agent 
Built 





Figure 3-7. The build Nexus password 


Set JAVA HOME, ANDROID HOME, GRADLE_HOME (see Figure 3-8 and the following code) 
and build the project. If any unit tests are written, execute that as the next build step. In 
this case, there are no unit tests. (Note: SONAR_RUNNER in this job is redundant; you'll use 
Sonar in a downstream Jenkins job.) 
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SSH Agent 
Build 


|!’ boas beak 
aE uncomment set -xv for debuging 


5 =l 
export PATH=$PATH: SOMAR RUBBER, bin 


export J0K_HOME=/Librar ryd lav raf lavavirtus lL! Machines/jdki 8.6 65. jdk/contents/hone/ 
export JAVA_HOME=/Library/Java/lavavirtualMachines -6.0_65.4 idk/contents fhome 
export PATH=$PATH: 520K _HOME/bin 

Android 

pat ANDROID HOME= "Users /mobile-ci/decuments/ Android SOE/android-sdk-r24. 4.1 
export PATHEEPATH: S4NDAOID HOME / (platforn- tools 

export PATHS SPAETH: $2NDAOTD_HOME/ tools 


#üradle 
GRADLE_HOME=/Users/mobile-cisgradle-2.8 


export GRADLE_HOM E 
export PATH=$PATH:SGRA0LE HOME/bin 


gradle clean asrerblebebug 








Figure 3-8. The build Nexus password 


#!/bin/bash 

## uncomment set -xv for debugging 

#set -xv 

export PATH=$PATH:$HOME/ .rvm/bin 

[[ -s "$HOME/.rvm/scripts/rvm" |] && source "$HOME/.rvm/scripts/rvm" 

pwd 

rvm list 

curl -u $NEXUS USERNAME :$NEXUS_PASSWORD -O https://nexus.com/nexus/service/ 
local/repositories/snapshots/content-mobile/MOBILE SNAPSHOT 

tar xvzf MOBILE SNAPSHOT 

cp app-debug.apk ./features/support/resources 

bundle exec cucumber features/android.feature DEVICE=$DEVICE -t @tag_name 


Upload the build artifact (i.e., app-debug.apk) to Nexus so that it can be used further. 

This example does not version this artifact with the Jenkins build number, because 
this is a snapshot. However, feel free to name the artifact aligned with your versioning 
strategy. See Figure 3-9. 
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!/bin/bash 
® Check if .apk gets created, if yes, upload to nexus 


a! /bia/bash 

files". /app/build/outputs/epk/app-debug. apk” 
= { -f “$file” } 

ther 


./app/build/outputs/ 
at <u SNEXUS_USPEMAME : NEXUS PASSHORO +u https: / amma s erica local /repositories/snaps ci 
else 

echo “$file sot found. Probably the build failed. Please check the path” 

f 


Trigger'call builds om other projects 
Build Trigg 





Figure 3-9. The build upload artifact 


Kick off the downstream job to trigger SonarQube analysis, which is feedback loop 2. 
The UPSTREAM BUILD NUMBER strategy is to pass the value to the downstream job to 
pull the “correct” Nexus build artifact, as shown in Figure 3-10. 


Jenkins «© <¢handrad + mobilo ci android © configuration 


L E 


Triggenicall builds on other projec 
Budd Treggers 
Projecte to baiki metile ei sonar 


W Block until the inggered propects finish iher builds 


Fad thie bald step if ihe ingpered Gadd ig worse of egaa io FAILURE 


Mare thet buik as faie if the agend kutdi warpa or egual 1o FAILURE 


Mark thes build as unstable if the biggered build is wame a equal to UNS TABLE 


Predefined parameters 
Paramotor | UPSTREAM BUILD _NUMBER=BUILD_NUMBER 





Figure 3-10. The build trigger job 
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Finally, save the job, as shown in Figure 3-11. 


* conhguration 


_ Predefined parameters 
Parameters UPSTREAM _BUILD_NUMBER=SBUILD_NUMBER 


Add Parameters -* 


Add ParameterFactories Y 


Add buiki step = 
Post-build Actions 


Add post-build action -* 


as 





Figure 3-11. The build save job 
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Feedback (Execution Results) 


After running the Jenkins job, the console output looks like this (see Figure 3-12 also): 


:app:mergeDebugAssets 

:app: generateDebugResValues 

:app: generateDebugResources 

:app:mergeDebugResources 

:app: processDebugManifest 

:app: processDebugResources 

:app: generateDebugSources 

:app:processDebugJavaRes UP-TO-DATE 

:app:compileDebugJavaWithJavacNote: Some input files use or override a 
deprecated API. 

Note: Recompile with -Xlint:deprecation for details. 

Note: /Users/mobile-ci/jenkins/workspace/mobile.android/app/src/main/java/ 
com/android/app/request/print/gc/GCGetPrinters.java uses unchecked or unsafe 
operations. 

Note: Recompile with -Xlint:unchecked for details. 


:app: compileDebugNdk UP-TO-DATE 
:app: compileDebugSources 

: app: preDexDebug 

: app: dexDebug 

:app: validateDebugSigning 

: app: packageDebug 

:app: ZipalignDebug 
:app:assembleDebug 


BUILD SUCCESSFUL 
Total time: 1 mins 52.858 secs 


This build could be faster, please consider using the Gradle Daemon: 
https://docs.gradle.org/2.8/userguide/gradle daemon.html 
[mobile.android] $ /bin/bash /var/folders/m6/zpwf1w6s04b _ 
ccjvm4175y4ho000gp/T/hudson7459346908680899717.sh 
a ./app-debug-unaligned.apk 
a ./app-debug.apk 

% Total % Received % Xferd Average Speed Time Time Time Current 

Dload Upload Total Spent Left Speed 


0 o o0 0 o0 0 0 o a E 


oc --1--!-- o* Trying 192.168.1.71.. 
* Connected to nexus.server.com (192.168.1. 71) port 443 (#0) 
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0 o 0 0 0 0 0 0 Spa Bayes 
Soe, Shree <= o* TLS 1.2 connection using TLS DHE RSA WITH AES 256 CBC SHA 


* Server certificate: *.company.com 

* Server certificate: Go Daddy Secure Certificate Authority - G2 

* Server certificate: Go Daddy Root Certificate Authority - G2 

* Server auth using Basic with user ‘jenkins' 

> PUT /nexus/service/local/repositories/snapshots/content-mobile/MOBILE 
SNAPSHOT HTTP/1.1 

> Host: nexus.server.com 

> Authorization: Basic amVua2luczpJbmihcjIwMTU= 

> User-Agent: curl/7.43.0 

> Accept: */* 

> Content-Length: 24952303 

> Expect: 100-continue 

> 

< HTTP/1.1 100 Continue 

} [16384 bytes data] 

22 23.7M 0 O 22 5536k O 5327k 0:00:04 0:00:01 0:00:03 5323k 
64 23. 7M 0 O 64 15.2M O 7670k 0:00:03 0:00:02 0:00:01 7670k* 


We are completely uploaded and fine 
HTTP/1.1 201 Created 
Server: nginx/1.1.19 
Date: Tue, 08 Dec 2015 16:00:35 GMT 
Content-Length: 0 
Connection: keep-alive 
X-Frame-Options: SAMEORIGIN 
X-Content-Type-Options: nosniff 


N NNNNA" 
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android > #15 


tapp:mergeDebugAssets 

tapp:generateDebugResValues 

tapp:generateDebugResources 

tapp:mergeDebugResources 

tapp: processDebugManifest 

app: proces sDebugResources 

rapp:generateDebugSources 

tapp:processDebugJavaRes UP-TO-DATE 

rapp:compileDebugJavaWithJavacNote: Some input files use or override a deprecated API. 
Note: Recompile with -Xlint:deprecation for details. 

Note: /Users/mobile- 
ci/jenkins/workspace/mobile.hopster_android/app/src/main/java/com/inmar/android/app/hopster/reque: 
etPrinters.java uses unchecked or unsafe operations. 

Note: Recompile with -Xlint:unchecked for details. 


rapp:compileDebugNdk UP-TO-DATE 
rapp:compileDebugSources 
rapp:preDexDebug 

rapp:dexDebug 
rapp:validateDebugSigning 
rapp:packageDebug 
:app:zipalignDebug 
:app:assembleDebug 


BUILD SUCCESSFUL 
Total time: 1 mins 52.858 secs 
This build could be faster, please consider using the Gradle Daemon: 


{mobile.hopster_android] $ /bin/bash 
{var/folders/m6/zpwfilw6s04b ccjvmi175y4h0000gp/T/hudson7 459346908680899717.sh 


rapp: dexDebug 

tapp: volidateOcbugSigning 
tapp:packageDebug 

:app: tipaligndebug 
tapp:assembleDebug 


BUILD SUCCESSFUL 
Total time: 1 mins 52.858 sees 


This build could be faster, please consider using the Gradle Daemon: d 
[mobile.hopster_android) $ /bin/bash /var/folders/e6/zpwflwsse4b vec jvaki?Syaheeepen/ 1 /hudeon?459540900080850717. sh 
à ./app-debug-unal igned . apk 
a ./app-debug.apk 
X Total X Received & Xferd Average Speed Time Time Time Current 
Dlead Uplcad Total ‘Spent Left Speed 


ð ô è @ ò 8 è Ò =sieeiee seleei=ee =ejeeime e" ‘Trying Miamemeumene._. 
* Connected to @exus. Emenee) port 443 (r0) 


o e 2 8 9 8 o È <cfesiee cepeng sef-ss-- e* TLS 1.2 connection using 
TLS_OHE_RSA_WITH_AES_256_CSC_SHA 

* Server certificate: *. 0D. com 

* Server certificate: Go Daddy Secure Certificate Authority - G2 

* Server certificate: Go Daddy Root Certificate Authority - G2 

* Server auth using Basic with user “jenkins’ 

> PUT /nexus/service/local/repositories/snapshots/ content -hopstermobile AMR MOBILE SNAPSHOT HTTP/1.1 
> Host: 

> Authorization: Sasic egQyimmabethejIwitu- 

> User-Agent: curl/7.43.0 

> Accept: */* 

> Content-Length: 26952303 

> Expect: 108-continue 

> 

< 


HTTP/1.1 183 Continue 
} [16384 bytes data) 


22 23.7" 2 @ 22 5536k @ 5327k 8:00:04 0:09:01 0:00:03 5323k 





Figure 3-12. Build results 
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Feedback Loop 2: Code Quality Analysis 


The second feedback loop is the code quality analysis process using SonarQube, as 
shown in Figure 3-13. 








Programmer 











Figure 3-13. Sonar feedback loop 
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Jenkins Job 2: Sonar 


Name the Jenkins job and define the Log Rotation strategy, as shown in Figure 3-14. 








@ Jenkins 
$ Bact to Dashoow Puayest nome mobie c sora 
se na Ba Andad sow poe! properties [be shoud be presert n the pecpect 
i vvorkxe 
© qire e 
7. Configure © 
& UNIQA 
r aii "9 
Do - 
Figure 3-14. Sonar job rotation 
Specify where the Sonar runner is available, as shown in Figure 3-15. 
mobile.ci_ sonar onfigurat 
Docker Container 
GitHub project © 
Notify when Job configuration changes 
~ This buid is parameterized © 


Suring Parameter 
Name SONAR_RUNNER 


Defaut Value 1 ic ors/pmacharlsonarcunner-2.4 


Description 





Figure 3-15. Sonar runner 
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Restrict where the project can be run and then download the source code. See 
Figure 3-16. 


Add Parameter ~ 
Permission to Copy Antia 
Restici build exec ution auses 
Propane an envirorenent for ihe run 
Deable Buld (Mo mew buikds wall be executed until the project a re-enabled | 
Execute concurrent builds if niceseary 


# Restrict where this propect can be nan 


Label Expression Mac Minitab 


2 ee oo © 


Lake) is. seniced by 1 node 


Advanced Project Qmions 


Source Code Management 
| Nene 
WS 
J NS Payeciset 
= tol 


Repositories 
hips: Ngiyub comma hege g andad app source. git 





Figure 3-16. Sonar source code 


Specify the checkout strategy, as shown in Figure 3-17. 


cisancloid 


Branches te build Branch Specifier (plank for any) | ss ter 


Add Branch 


Repository browser 





Build Trieaore 


Figure 3-17. Sonar checkout 
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Here you don't have sonar-project.properties inside the source code, so you can 
download it from Jenkins config file store and then add it to the check-out folder. See 
Figure 3-18. 


configuration 


O Subversion 
Build Triggers 
Trigger builds remotely (e.g, from scripts) 
| Build after other projects are built 
J Build penodic ally 
— Build when a change is pushed to GitHub 
| Poll SCM 


© 0909 


Build Environment 
* Delete workspace before build stans 
Advanced... 
J Mask passwords (and enable global passwords) 
Y) Provide Configuration files 
Managed Files File 


99 


Cae) ob» e-s onar-project - sonar-project properties ’ 
Target sonarproject properties 


® 


Vanable sonar © 


Add file 


Figure 3-18. Sonar project properties 


Since the config files are generally copied to the Jenkins master, you can move them 
to the build machine and hence use the $sonar variable as a carrier. See Figure 3-19. 


Abort the build if it's stuck 
Color ANS! Console Output 
% Copy files into the job's workspace before building 


Files to copy Ssonar 


Paths are relatveto = @ $JEIKINS_HOME/userContent 


This job's workspace on the master (not advised) 


Inject environment variables to the buld process 
Inject ownership variables into environment 


Inject passwords to the build as environment variables 
Restore OS X keychains after build process as defined in global configuration 





peni 


Figure 3-19. Sonar job rotation 
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You add a build step using the SonarQube plugin for Jenkins and configure it to use 
the sonar-runner, as defined on the Jenkins System configuration page. See Figure 3-20. 


| Invoke Standalone SonarQube Analysis 
Task to nun 


JDK 


{Inherit From Job) 


JOE to be used for fia sone sok 


SonarQube Runner biletab 


Path to propect properties 


Analysis properties 





Figure 3-20. Sonar job rotation feedback (execution results) 


After you run the job, the Jenkins console log looks like Figure 3-21. 


ndroid_ sonar +» #1 


10:30:22.135 INFO - Load global repositories 
10:30:22.561 INFO Load global repositories (done) | time=43ems 
19:30:22.564 INFO Server id: 20151105102752 
10:30:22.566 INFO - User cache: /Users/mobile-ci/.sonar/cache 
16:30:22.579 INFO Install plugins 
10:30:22.587 INFO Download sonar-stylecop-plugin-1.1. jar 
16:30:22.615 INFO Download sonar-javascript-plugin-2.6. jar 
10:30:22.747 INFO Download sonar-resharper-plugin-1.6. jar 
10:30:22.752 INFO Download sonar-android-plugin-1.1.jar 
10:30:23.009 INFO - Download sonar-xml-plugin-1.2.jar 
10:30:23.224 INFO Download sonar-web-plugin-2.3. jar 
10:30:23.285 INFO Download sonar-110n-en-plugin-5.1. jar 
10:30:23.290 INFO Download sonar-clover-plugin-3.@. jar 
10:30:23.339 INFO Download sonar-python-plugin-1.5.jar 
10:30:23.371 INFO Download sonar-scm-git-plugin-1.0. jar 
10:30:23.444 INFO Download sonar-jira-plugin-1.2. jar 
18:30:23.515 INFO - Download sonar-scm-svn-plugin-1.8. jar 
10:30:23.525 INFO Download sonar-pmd-plugin-2.4.1.jar 
10:30:23.668 INFO - Download sonar-core-plugin-5.1.jar 
10:30:23.735 INFO Download sonar-java-plugin-3.5.jar 
10:30:23.821 INFO - Download sonar-csharp-plugin-4.@. jar 
10:30:23.933 INFO Download sonar-cobertura-plugin-1.6.3. jar 
10:30:23.937 INFO Download sonar-email-notifications-plugin-5.1. jar 
16:30:23.959 INFO Download sonar-build-breaker-plugin-1.1. jar 

:30:24.121 INFO Install JDBC driver 

:30:24.125 INFO - Download postgresq]-9.3-1102-jdbc41. jar 

:30:24.145 INFO Create JDBC datasource for jdbc:postgresql://10.102.12.51:5432/ postgres 

130:25.438 INFO Initializing Hibernate 

:38:26.934 INF Load project repositories 





Figure 3-21. Sonar console output 
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Click the SonarQube icon. It will open the SonarQube home page/dashboard as you 
have configured it on the server. See Figure 3-22. 


@ Jenkins 








Jenkins ‘eyes mobile ia ame 


4 Back to Dashboard 

C Status 

Changes 

W Workspace 

K) Build with Parameters 
Q) Delete Project 

F Configure 


4 Manage Ownership 


\ SonarQube 





SonarQube 





€ Job Config History 


— 
E 
aag 
= af 
———| 
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a slave workspaces 30 MB 
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Figure 3-22. Sonar icon link 


Figure 3-23 shows the Sonar Dashboard and each of the orange highlights (and many 
more hyperlinks) opens information that contains great feedback for developers. 
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Figure 3-23. Sonar Dashboard 
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Feedback Loop 3: Test 


This feedback loop is the integration automation test—i.e., the acceptance tests that an 
end user would experience (see Figure 3-24). This is the relative difficult part to automate, 
so I discuss it in detail in Chapter 8. 


venus 
Github Ae, Pi S. SonarQube 


Cl Server 


Y Checkout code 
S Some: antes, + More Stes Ie itting 
ee re ieee ce Y Trigger Acceptance Tests 
“ Trigger Code Quality Analysis - ; 
E] 
1 2 
J Frogrammer 


Appium - android / 




















= Deploy app 
“ Smoke/Sanity Tests 
w Feature Acceptance Tests 



















‘oon 









Webtviver Cord oiii 





Figure 3-24. Test feedback loop 


Jenkins Job 3: Acceptance Tests 


Name the Jenkins job as smoke tests/acceptance tests, depending on how many you want 
to execute. This example uses smoke tests, as shown in Figure 3-25. 
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@ Jenkins D PrnieepMachara 0900 


Jenks -arnkod mobde awid sorcke bests 


A Back to Dasnpoarc Project name mobile c\_ancroid_smoke_tests 
| Status Descnption 

T> Changes 

oe Workspace 

(2) Suns wan Parameters [Plain text] Preview 

© Delete Projec! Discard Old Builds 

7 Contigure Suanegy Leg Raaton 


& Manage Ownership Days to keep builds 


K3) Cucumber Reports os 
, Max # of builds to keep 15 
Fe 10b Contig mistory 





Figure 3-25. Test job rotation 


Enter the Nexus username if you want to upload the results of the test execution 
(this example does not). Then define the DEVICE string parameter and add all the devices 
that are defined in the devices. yaml file in the acceptance tests projects. See Figure 3-26. 


müti ci amiee smoke betis Con apa ii 
String Parameter 
nnn NEXUS_USERNAME 
alaull Wi ? 
Defaut Walse jerking 


Deserpien 


[Plain text) Preview 


Cholee Parameter 


Manse DEVICE 


ic an motordla-googhe M1E222F:00 
ies _ 551 1G bata 
Ige-nenus 44a? 19ae Sale si? 
hic-one-HTSESWO1 16 
sameungstid Ohaeddbdb? 1h t 


td R 
Destriphion Valid Devices list 





Figure 3-26. Test Nexus and device parameters 
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Specify where the project should run and download the acceptance tests code, as 
shown in Figure 3-27. 


chandmed + mobdeci_amdrod_smocke_tests + configuration 
Add Parameter = 
| Pembesi jū Copy Arifact 
O Festi baid erection toutes 
T Peppard an emionmeri fer the mun 
I Disable Bwild (Mo new builds wil be mecuied antl the progect i3 re-enabiad | 


| Execute conturent buddy H necergary 


1 Reiet whee thes project can be nun 
Label Exprenaion Mise Mirada 


Label is sericed by 1 node 
Adwenced Project Options 


Source Code Management 
G None 
© ws 
© CVS Projecte 
Gn 


Repodiloies i 
Repository URL | bapa jsoithuts ccmvmarhagzaicl_androk!_sceeplaretwnts. ot 


Crets 





Figure 3-27. Test source code 


Specify the master branch for code checkout, as shown in Figure 3-28. 


mobde.ci_androsd smoke losis + configuration 


Branches to baste Branch Specifier (blank for ary} ernaster 


Ackbbonal Behaviowg 


Subversion 
Build Triggers 


Trigger builds remotely (ag. from scripis} 
| Bild after other projects ane buill 

O Buld perigee ally 
| Buki when a change is pushed to GilHub 





Figure 3-28. Test Nexus and device parameters 
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For Ruby dependencies, pull gems from the Nexus repo. You must then specify the 
Nexus access credentials, as shown in Figure 3-29. 


crandrond mbie ci_androd_=smose_tests configqurabon 


= = m 


Delete wearin pare build sharia 


Acrinced_ 


E Mask passwords (and enable global passwords) 










Password Parameters, of any other type of bald parameters selected for masking in Hudson'’s{Jenkins main configuration screen (Manage Hudson > Configure System) ell be actomall al 
masked 


Pabtawd 


Pride Conigamika files 

Abort the buld if ita stuck 

Color AMS | Console Oulpul 

Copy files. into the jobs workspace before building 
= Tepe arene vanabies bo the buid propers 

epee cee hp Hares mio emanen 


irti pasavecrds fo the build as environment wamables 
Giba pasarvonds 


Mame | NEXUS PASSWORD 


Figure 3-29. Test Nexus access for Jenkins 


Download the app from Nexus, place it in the resources folder, and then execute the 
acceptance tests. See Figure 3-30. 


Eo phaid o eet) and ace Wait ā + | Cc omiguraiion 


Aili 


Paame ba 
Mack pasword parameners s 


I Revie ÖS X keychana after build peocess as defined in global configuration 


SSH Agent 
Build 


Execute shell 


1 /biafbash 

|i uncomment set «v for dehaging 
Sret -wv 

export PATH=SPATH: SHOVE! eres bis 


(Cl -= “SHOE rvemscriptssree” ]] $E source “SHOES eeiseriptssires” 

peil 

Am List 

curd -u RWSL WRAP SNE PRRRRORD -0 hitpE n neari. celecdentfiramework, con nirai rerrdcesiocalsrepocitories/prapshote content -framer E CONTACT SPFA 
| ter xvet CONTACT SHAPSHOT 


cP app-debug. apk .featuresMampporetireicucces 
| tundle exec cucumber feateresicd endroid, feature DEVICE=SDEVICE 





Figure 3-30. Test Nexus and device parameters 
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#!/bin/bash 

## uncomment set -xv for debuging 

#set -xv 

export PATH=$PATH: $HOME/.rvm/bin 

[[ -s "$HOME/.rvm/scripts/rvm" |] && source "$HOME/.rvm/scripts/rvm" 


pwd 
echo $UPSTREAM BUILD NUMBER 
rvm list 


curl -u$NEXUS USERNAME:$NEXUS PASSWORD -O https://nexus.inmar.com/nexus/ 
service/local/repositories/snapshots/content-mobile/HOPSTER MOBILE _ 
SNAPSHOT $UPSTREAM BUILD NUMBER 

ls -1 

bundle exec cucumber features/android.feature:19 DEVICE=$DEVICE 


Choose Publish Cucumber Results as a Report, as shown in Figure 3-31. 


bie ci anbud smoke tests 


Pua list 
cor] -u QUO USE: SUS FAS AED =o hetps: /finewud. celeniunframework,comfnexus/ services local frepotltorles/snapthots/ content -franesork/OONTSCT SHEP iH 
tar wif OOMTACT SUAPEHOT 
op app debug.apk . features/ suppart/iresources 
| bud le rèc cucumber Tantured ci old. feature Peviceedevice 


Add buld sip 7 


Patella Action 


Fubligh cucumber reel ag a rapan 





Add pottibulid action = 


Figure 3-31. Test publish Cucumber results 
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Feedback (Execution Results) 


Since you choose to publish the Cucumber results as a report, you can get reports, as 
shown in Figures 3-32 and 3-33. 


| Cucumber 


Reports 








Steps 


a Cucumber 


Reports 


Scenarios 
































20s $2 ima 
TE 


Figure 3-32. Test Cucumber graphical reports-1 
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Figure 3-33. Test cucumber graphical reports-2 
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CHAPTER 4 


Android System Setup 





Chapter 3 focused on how fast you can get to a quick feedback loop, and this chapter 
covers what is needed for an MVP. The Android world has great tools and utilities that 
address the varied needs of a developer. 

You will install the following so that you can learn to build an app: 


e Java 

e Android SDK 

e Android Studio 
e Gradle 


Installing Java 


This section explains the Java platform and how to install it. 


JRE vs. JDK vs. SE 


You will download and install the Java Development Kit (JDK) in this section. As a quick 
refresher, you might wonder which Java package you need. 


e JDK: Software developers generally tend to use the JDK. It 
includes the Java runtime and libraries for troubleshooting and 
monitoring applications. 


e SE (Standard Edition): Administrators typically use the SE 
version. 


e JRE (Java Runtime Environment): This is the minimal version 
used by end users to run Java applications. 
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JDK on Mac 


To install the JDK on your Mac, you simply accept the license agreement, download the 
. dmg file, and install it, as shown in Figure 4-1. 


C | D wew.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html 
PR DEEE E E EE EEG E E 
New to Java + Java Developer Day hands-on workshops (free) and other events 
Community » Java Magazine 
Java Magazine JDK 8u65 Checksum 
JDK 8u66 Checksum 


Java SE Development Kit 8u65 


You must accept the Oracle Binary Code License Agreement for Java SE to download this 
software. 


Accept License Agreement © Decline License Agreement 


Product / File Description File Size Download 
Linux ARM v/v? Hard Float ABI 77.69 MB jdik-Bu65-linux-arm3?-vip-hilt tar gz 
Linux ARM v8 Hard Float ABI 74.66 MB jdk-fu65-linux-armé4-vip-hilt tar gz 
Linux x86 154.67 MB jdik-Bu65-linux-i586,.rom 
Linux x86 174,84 MB jdik-Bu65-linux-i586. tar oz 
Linux “64 152.69 MB jdik-8u65-linux-x64 mom 
ip i Oe P iiie hni inay Ea ni 











Olan SPARL. abet ed Bede JE | Taa. r1 MIS KIR =U Baisi Ya r 
Solaris SPARC 64-bit 99.01 MB jdk-fub5-solans-spare vo. tar.gz 
Solans x64 (SVR4 package) 140.22 MB pdk-fu65-solans-xi-4. tar! 
Solaris x64 S6.74 MB jdk-fu65-solarns-x64. tar.gz 
Windows x86 181.24 MB jdik-Bu65-windows-i886 exe 
Windows x64 186.57 MB jdk-Bu65-windows-x64 exe 


Java SE Development Kit 8u66 


You must accept the Oracle Binary Code License Agreement for Java SE to download this 
software. 
Accept License Agreement © Decline License Agreement 


Product / File Description File Size Download 
Linux x86 IH 6r MB jdk-Su66-linux-i526. rom 


Figure 4-1. JDK download for the Mac 
After installing and making modifications to ~/. profile, you'll see something 
similar to the output shown in Figure 4-2. Ensure that the Java executable is available 


on the path and that the shell variables $JAVA_ HOME, $JDK_HOME, and $PATH are updated 
as shown. 
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hoe bash 


Anyones—-Mac-nini:~ pmacharl$ which java 
fuerfbinf java 
Anyones-Macsninit~ paacharis ls =1 fuse/bin/jave 


export JOK_HOME=/Library/Java/JavaVirtualhachinessjdk1.8.0_60. jdksContentss Home 
export JAWA_HOMEsS(usr/lLibexec/ java_home) 
export PATH=$PATH: $JDK_HOME/bin 















export ANDROID _HOME=/Users/pmacharl/flibrary/android/sdk 
export PATH=SPATH: SANDROID_HOME/plattorn-tools 

export PATH= $PATH: $4NDROID_HOME/ tools 

šüradle 
GRADLE_HOHE=;/Users/paacharl/Installations/grodle-2:7 
export GRADLE_HOME 

export PATH=$PATH: §GRADLE_HOME/ Bin 


FApp Luc 


export PATH="SPATH: $HOME/.revnybin" # Add AVM tö PATH for s¢ripting 


[[ -s “SHOME/.rva/seripts/rve" |) 6&6 source "SHOME/.rve/seripts/rve" & Load BVM inte a shell session +as a functions 


Anyonte=-Mace-mini:= pmacharls 


Figure 4-2. Shell variables 
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pmacharkeCORP-NEXUS: - 


LWW =X% Loroot wheel 74 Oct 17 2014 fusrsbinf java -> /SystensLibrary/Frameworks/sJavaVM, framework /Versions/Current/Commands/ java 


export JDK HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0 60. jdk/Contents/Home 


export JAVA HOME=$(usr/libexec/java_ home) 
export PATH=$PATH:$JDK_HOME/bin 


Installing Android SDK 


Android SDK tools can be installed from the Android developer site. If you are a 


developer, it makes more sense to download Android Studio (which comes bundled with 
the SDK). However, if you are a devops/build/release/CI engineer, you might want to do 


things headless, so it makes more sense to download the standalone tools. 
This book focuses more on doing things headless, because IDEs in the background 


mostly call the commands. 
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Standalone SDK 


Download the standalone SDK from https: //developer.android.com/studio/index.html. 
Navigate to the bottom of the page for installing the tools, as shown in Figure 4-3. 


e C ` developer.ancroid.com/sck/index. htrritOther Qs 
im Developers Develop > Tools > Download Android Studio and SDK Tools $ Developer Console Cc 
download the stand-alone Android SDK Tools. These packages provide the basic SDK tools for app development, 
Download X without an IDE. Also see the SDK tools release notes. 
GS ae Platform | Package Size SHA-1 Checksum 
Windows installer_r24_4.1-windows.exe 151659917 £9b59d72413649d3 16633207e31f456443e7 ea0b 
Adding SOK Pecheges (Recommended) bytes 
Android Studio android-sdk_s24.4,1- 199701062 66b626433053c152b22bfScab1 9cOf3fef4eba49 
windows. zip bytes 
Workflow ¥ Mac OS X android-sdk_r24_4.1- 102781947 85a9cccb0b 1f9e6f1f616335c5f07107553840ed 
macosx.zip bytes 
Tools Help 
Linux android-sdk_124.4, 1-linux.tgz 326412652 725bb360f0f7 d04eaccifSa2d57abdd49061 326d 
Build System z bytes 


Figure 4-3. Android SDK download 


The contents are extracted to the /Users/pmacharl/Library/Android/sdk folder, as 
shown in Figure 4-4. 


um 
Pn sdk 

-5 
> A M Accounts > A P sdk >» P add-ons r 

I Address Book Plug-ins » B build-tools > 
> P Android > Mi extras > 
>» |) Application Support r B platform-tools > 
> D Assistants t B platforms > 
> i D Audio r = SDK Readme.txt 

D Caches > P sources > 
> [| Calendars e I) system-images > 
> | P ColorPickers r B temp e 

B Colors + D tools > 

P com.appile.nsurisessiond » 
>» | B Compositions r 
> | B Containers > 


Figure 4-4, Android SDK folder view 
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Now add these shell variables to the ~/. profile path (see Figure 4-5): 
e ANDROID _HOME=/Users/pmacharl/Library/Android/sdk 
e PATH=$PATH:$ANDROID HOME/platform-tools 
e PATH=$PATH:$ANDROID_ HOME/tools 


Anyones-Mac-miniiedk paacharl cat ~/. profile 

export JDK_HOME=/Library/Java/sJavaVirtualMachines/sjdki1.8.8_60. jdk/Contents,/Home 
export JAVA_HOME=s$(usr/libexec/ java_home) 

exoort PATH=SPATH:S10K H ibin 
Mro 
export ANDROID_ĦMOME=/Users/ pmacharl/Library/Anñndroid/ sok 
export PATH=SPATH: SANDROIO_HOHE/platform-tools 

export PATH#SPATH: SANDROID_HOME/ tools 











#6rad le 


GRADLE_HOME=/Users/pracharl/Instal lat ions/gradle-2.7 
export GRADLE_HOME 


export PATH=$PATH: SGRADLE_HOME/bin 


Appium 


export PATH=" $PATH: SHOME/.rvm/bin" # Add AVM to PATH for scripting 


[[ -=s “SHOME/.rve/seripts/rvm" ]] G6 source “SHOME/.rvm/secripts/rvm" # Load AVM into a shell session +as a functions 
Anyones—Mac-mini:sdk pmacharls | 


Figure 4-5. Update shell variables 


Quick Checks 


Since you will use the adb and uiautomatorviewer executables in subsequent sections, 
it’s smart to check that they are available in the PATH now. 
Type ulatomatorviewer, as shown in Figure 4-6. 


node ke @@a ish 
Anyones-Mac-mini:sdk pmacharl$ adb devices 
List of devices attached 


00a219ae09d05912 device P A 


Anyones-Mac-mini:sdk pmacharl$ uiautomatorviewer 


Node Detail 


Figure 4-6. uiautomatorviewer 
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Press Ctrl+C in the shell or close uiautomatorviewer directly. 
This ensures that you have Android SDK set up and ready for building apps. 


Installing Android Studio 


In the previous section, you installed the Android SDK as a standalone and made it 
available to your build environments by setting the PATH variables. 
In this section, you will learn how to install and set up Android Studio. 


Note Android Studio is not required for building, deploying, or testing apps. It is a 
developer environment that enables you to develop apps. 


There are many benefits to having Android Studio, because the IDE centralizes 
accessibility of features like updating the SDK, adb, the device monitor, looking at logs, 
and more. Hence, it is strongly recommended that you install Android Studio even 
though it’s not required. 

Download it from https://developer.android.com/studio/index.html. 

See Figure 4-7. 


€ En developer.android.com/sdk/insialling/index.htmi? pkg=stucio 
a 
il Vevelopers Design Develop Distribute Developer ( 
Training API Guides Reference Tools Google Service 
Download 


Installing Android Studio 


Android Studio provides everything you need to start developing apps for Android, including the Android 


Installing the SDK 


Adding SDK Packages Android SDK tools 


If you didn't download Android Studio, go download Android Studio now, or switch to the stand-alone SD 
Android Studio 
instructions 


Workflow Before you set up Android Studio, be sure you have installed JDK 6 or higher (the JRE alone is not suffic 


Figure 4-7. Install Android Studio 


Follow the instructions from the installer and go with the defaults. 
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Android Studio Basics 


In this section, you will walk through some of the functionalities in Android Studio that 
matter to the use cases in this book. Just follow along and click through at this stage in 
the book. 

Open an Android project. Point to the Android project that you are working on, as 
shown in Figure 4-8. 


Zo Welcome to Android Studio 


Recent Projects Quick Start 





x Import an Android code sample 

$ Check out project from Version Control 

Py Import project (Eclipse ADT, Gradle, etc.) 

Psi Configure H 


Ee Docs and How-Tos. > 


Figure 4-8. Open the Android project 
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Hover over the icons shown in Figure 4-9 and click each to get a feel for navigating in 
Android Studio. 








Figure 4-9. Android Studio subtools 


Hovering over the icons highlighted in Figure 4-9 shows you options related to the 
following: 


e AVD Manager: This will launch AVD manager. You will learn 
how to create emulators and manage Android virtual devices in 
another section. 


e SDK Manager: This will help you manage all updates to the 
Android SDK. 


e Android Device Monitor: This will let you monitor your Android 
device when connected and talking to adb. 


Associate the System SDK with Android Studio 


By default, Android Studio comes bundled with Android SDK. However, if you are 
already using an SDK bundle (as mentioned in previous section, if you already have SDK 
downloaded and set in another folder), then point it to that. 


= Note Remember that this book uses an SDK downloaded separately because you need 
the flexibility to be able to build, deploy, and test the examples with and without Android 
Studio. 
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At the top left, choose Android Studio > Preferences to open up this page. Edit the 
value to point to the folder where you downloaded the Android SDK. See Figure 4-10. 





[Ed 


Appearance & Behavior > System Settings > Android 50K 


Y Appearance & Behavior Manager for the Android SOK ane mn Í 
Appearance Android SDK Location: f | /Users/pmacharl /Library/Android/sek 







Menus and Toolbars SDK Tools SOK Update Sites | 


T System Settings 
Each Android SDK Platform package includes the Android platform and sources pertaining ta 


P I 
os an API level by default. Once installed, Android Studia will automatically check for updates. 
HTTP Proxy Check “show package details” to display individual SOK components. 
Updates Nime AR Levei Revision Status 
Usage Statistics = Android 6.0 (Marshmallow) 23 i Update available 
- Android 5.1 (Lollipap) è? Fi Mot installed 
Android SDK Android 5.0 (Lollipop) 21 2 Not installed 
File Colors T Android 4.4 (KitKat Wear) 20 2 Mot installed 
Scopes i Android 4.4 (KitKat) 19 4 Not installed 
Novinicatfons Android 4.3 (elly Bean) 18 3 Net installed 
Android 4.2 (jelly Bran) 17 3 Mor Installed 
Quick Lists Android 4.1 (Jelly Bean) 16 5 Not installed 
Keymap Android 4.0.3 JeelreamSandwich) 15 5 Mot installed 
» Editor Android 2.3.3 (Gingerbread) 10 Fd Mot installed 
Android 2.2 (F & 3 Not installed 
Plugins = wooo a 
bo Wersion Control 
& Build, Execution, Deployment 
E Languages & Frameworks 
& Tools _ Show Package Details 
Launch Standalone SOK Manager Preview packages available! Switch to Preview Channel to see them 
ts Cancel | Apply OK 


Figure 4-10. Associate SDK with Android Studio 


Installing Gradle 


Gradle is a build package manager that helps dependency management when building 
Android apps. Compare it with Ant, Maven, npm, Rake, etc. 
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Download and Install 


Download the binary from https: //gradle.org/gradle-download/. It is an archive, so 
you need to extract the contents to a folder on your machine. See Figure 4-11. 


G | B Secure | https /gradieorginstall 
[D Suggested Sites Dl Inmar Favorites 


Scoop is. a command-line installer for Windows inspired by Homebrew, 
$ scoop instali gradile 


Install manually 
latest Gradle distribution 





1. Download th 


The current Gradle release is version 3.5, released on 10 Apr 2017. The distribution zip fle 
comes in two flavors: 

æ Binary-only 

= Complete (with docs and sources) 


If in doubt, choose the binary-only version and browse docs and sources online. 
Need to work with an older version? See the releases page. 

Step 2. Unpack the distribution 

Linux & Macs users 


Unzip the distribution zip file in the directory of your choosing, e.g- 
$ mkdir foptsgradle 


Figure 4-11. Download Gradle 


Figure 4-12 shows where it looks after it’s extracted. The version being used is 2.7, but 
you should download the latest version you can. There are not too many differences that 
will affect your Android app build. 


2a 
B Applications > A [P] gradie-2.7 > bin > 
Assets.car 3 changelog.txt 
D Base.lproj r © getting-started.htm! 
B Desktop e P init.d r 
© Documents r Bi iib r 
= Downloads > LICENSE 
S droidAtScreen-1.2.jar M media + 
M Frameworks > NOTICE 
P gitprojects > 
>, Hopster 
Info.plist 
F Installations r 


Figure 4-12. Gradle folder structure 
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Set Gradle Shell Variables 


Add the following code to your ~/. profile so that the Gradle binary is available in $PATH 
and $GRADLE_ HOME is available when building the Android app. See Figure 4-13. 


node bash bash pmachari@CORP 
Anyones-Mac-mini:sdk pmacharl$ cat ~/.profile 
export JOK_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_60.jdk/Contents/Home 
export JAVA_HOME=$(usr/libexec/java_home) 
export PATH=SPATH:$SJOK_HOME/bin 
#Android 
export ANDROID_HOME«/Users/pracharl/Library/Android/sdk 
export PATH=SPATH: SANDROID_HOME/platform-tools 
export PATH=$PATH: SANDROID_HOME/tools 


#Gradle 
GRADLE_HOME=/Users/pmacharl/Installations/gradle-2.7 


export GRADLE_HOME 
export PATH=SPATH: SGRADLE_HOME/bin 





#Appiur 


export PATH="$PATH: SHOME/.rvm/bin" # Add RVM to PATH for scripting 


a -; “SHOME/. rvm/scripts/rve" )) && source “S$HOME/.rvm/scripts/rvm" # Load RVM into a shell session «as a functions 
Figure 4-13. Gradle shell variables 
GRADLE_HOME=/Users/pmacharl/Installations/gradle-2.7 


export GRADLE HOME 
export PATH=$PATH:$GRADLE_HOME/bin 


Android Studio with Gradle 


Android Studio comes bundled with Gradle and uses its own version internally. If you 
are a developer, you might find it more comfortable to use the built-in version so that you 
don’t have to manage yet another tool. 
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Since you need the flexibility to do this with an IDE and do it in the CI (headless) 
way for this book’s examples, I suggest you direct Android Studio to use the Gradle 
downloaded previously, as shown in Figure 4-14. 


Build, Execution, Deployment > Bulld Tools > Gradle For current project Reset 


y 


Appearance & Behavior 
Keymap 

Editor 

Plugins 


Linked Gradie projects 


v 


y 


Version Control 
Project-level settings 


4 


Build, Execution, Deployment 


Y Build Tools Use default gradle wrapper (recommended) 
®) Use local gradle di [tribution 
Experimental 
Cloud Test Lab Cradle home: /Users/prnacharl/installations /gradle-2.7 
Compiler Global Gradle settings 
Coverage 
Offline work 
> Debugger 
Path Variables Service directory path: 
> Languages & Frameworks 
> Tools 
? Cancel Apply OK 


Figure 4-14. Gradle setting in Android Studio 


Gradle Quick Commands 


gradle --help will give you the options for quick commands. 


Gradle Tasks 


Gradle works by executing tasks. There can be two types: 
e Built-in tasks: Come by default 
e Gradle custom tasks: Craft your own tasks 


You will use the built-in tasks to start with. It’s beyond the scope of this chapter to go 
into the details of writing custom tasks. 
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Built-in tasks are categorized into the following areas: 
e Android tasks 
e Build tasks 
e Build Setup tasks 
e Help tasks 
e Install tasks 
e = Verification tasks 
e Other tasks 


To see all the tasks and more detail, run gradle tasks --all. 
To see more details about a task, run gradle help --task. 


Build the App 


Gradle generally looks for a build. gradle file in the current directory and parses the file 
to follow the instructions. 

In this book, you will build the app using the following command, which runs inside 
the Android project root directory: 


gradle clean assembleDebug 


I will go into details about building the app from the project in subsequent chapters. 


Note If you do not want to worry about managing Gradle versions (downloading, 
extracting, and ensuring the right version is used), you can use the Gradle wrapper. The 
Gradle wrapper comes bundled with Gradle. The only change is, instead of using the gradle 
binary, you use the gradlew binary in the same folder. 


Tools to Know 
Some of the Android SDK tools that I found useful (from the perspective of CI) are: 
e ADB (Android Debug Bridge) 
e Record Video 
e uiautomatorviewer 
e AVD Manager 
e SDK Manager 
e Device Monitor 


The next few sections cover how to use these tools. 
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ADB 


Android Debug Bridge (adb) is a client that runs on a developer box and instructs a 
component that runs on the developer box, which in turn communicates with a daemon 
that runs either on an emulator or on a real device. 

Here is an example of an adb command. It lists the number of devices connected to 
the machine on which adb is executed. 


pradeep@seleniumframework.com:~ pmacharl$ adb devices 
List of devices attached 
00a219ae09d05912 device 


This is one of the most important tools that I recommend you learn to use. You will 
use adb to communicate with the app on the emulator/real device, to install the app, and 
to accomplish many other feats. 

Here are some adb commands that I use extensively: 


e adb devices lists all emulators and devices that can 
communicate with this adb server. 


e adb install <apk> installs apk on the one emulator/device that 
is available to the adb server. 


e adb install -e <serial_number> <apk> installs apk ona 
targeted emulator or device. 


e adb kill-server kills the adb server. I use this when the server is 
in an unstable state. 


e adb start-server starts the adb server. 


It will be very beneficial to go over the complete list of options that adb provides, 
especially when you're troubleshooting. I recommend the official page, found at 
https: //www. gitbook.com/book/machzgcqg/ci-automation-mobileapps/edit. 

You will use the previous commands when you build-deploy-test the CI pattern in a 
later chapter. 


Record Video 


From Android Kitkat, i.e. 4.4 version and above, adb provides a way to record screen video 
and save it to the device storage. You can pull the video to the local system from there. 
Here are the steps for screen recording and saving: 


1. Startadb shell screenrecord /path. 


2. Recording starts and waits until you no longer need to record 
the screen. 


3. Press Ctrl+C in the shell to stop recording. 


4. Pull the video to your local filesystem. 
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pradeep@seleniumframework.com $ adb shell screenrecord /sdcard/example.mp4 ^C 
pradeep@seleniumframework.com $ adb pull /sdcard/example.mp4 
4972 KB/s (2900775 bytes in 0.569s) 


uiautomatorviewer 


From the perspective of an automation engineer, ulautomatorviewer is very similar to 
Chrome’s dev-tools, Firefox’s dev-tools, etc. Writing web-based automation code (such 
as with Selenium), identifying HTML elements (like ID, name, and other properties), 

and passing that as input to identify objects is very similar to what you can achieve with 
uilautomatorviewer, but on the mobile side. Figure 4-15 shows the interface. 


ctga 
i Cl 
aA “ We 
===- ¥ (0) View [0.50][768,1184] 
i ¥(2) View (Home screen 
J ) ¥ (0) View [40,185)[728 
et d (0) TextView:Comr 
Corsinissdte Brows ete » (1) LinearLayout {I 
¥ (2) LinearLayout {I 
FA (0) ImageView [ 
(1) TextView [4C 
REIA ¥(3) android.appwit 
Aaa (0) View {16:26} 
Node Detail 
OM meta oat the An eee index 2 
ROM My] DA Hie SHE TIPE e text 
class android.view. View 
package com.android. launcher 


content-desc Home screen 3 
checkable false 
checked false 
clickable true 
enabled true 
focusable false 
focused false 
scrollable false 
long-clickable true 
password false 


TestFight 





Figure 4-15. uiautomatorviewer 


Some notes about uiautomatorviewer: 
e It’s generally located in the $ANDROID HOME/tools directory. 
e You launch it by typing ulautomatorviewer. 


e Figure 4-15 is taken by clicking the Device Screenshot button, 
which is the second icon from the left. 
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e You can see the XML hierarchy of the elements and each node 
property in the node detail. This is useful when you're writing 
Appium automated tests (if you want to use uiautomatorviewer). 


e You can save a screenshot using this tool. 


AVD Manager 


The AVD Manager provides a graphical user interface in which you can create and 
manage Android Virtual Devices (AVDs), which are required by the Android Emulator. 

Launch AVD Manager using either of these options (one is from the command line 
and the other is from Android Studio): 


e Runtheandroid avd command at the command line. It launches 
avd (shell variables should be set so that the executables are in PATH). 


e Click the AVD Manager icon in Android Studio IDE, as shown in 
Figure 4-16. Figure 4-17 shows the AVDs. 


> Hi Gwe) eek OL 
< | $ i- | ®© app x 


apply plugin: 'com.android.application' 
apply plugin: 'com.neenbedankt.android-apt' 





android { 
compileSdkVersion 23 
buildToolsVersion "23.0.1" 


Figure 4-16. AVD Manager 


Your Virtual Devices 


KR Android Studio 








Type Name Resolution API Target CPU/AB Size on Disk Actions 
Nexus 4 API 23 768 x 1280: xhdpi 23 Googie APis x86 1 G8 b2v 
Nexus 4 API 23 x86 768 x 1280: xhdpi 23 Googie APis x86 1 G8 b2 
-+ Create Virtual Device. |...) 


Figure 4-17. AVD Manager with AVDs 
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When you start to understand the Android world, you want a sandbox to play with. 
Android Virtual Device Manager lets you create AVDs/emulators for different hardware 
and software configurations. I found the following features beneficial while learning the 
platform: 


e You can create emulators for phones, tablets, wearing, TV, etc. 


e You can play with different form factors, screen resolutions, and 
sizes. 


e You can experiment with different memory sizes, API levels of 
software, cameras, sensors, etc. 


Sure, there is no substitute for a real device, but emulators at least help you 
understand the various configuration(s) available, as well as identify which ones matter 
while developing, building, and testing the apps. More domain knowledge for the 
engineers means a higher chance of a better quality app. 


SDK Manager 


The Android SDK Manager (see Figure 4-18) separates the SDK tools, platforms, and 
other components into packages for easy access and management. 


SDK Path: 
Packages 
im! Namo API Rov. Status 

Y Tools 
© Android SDK Tools 24.4.1 Œ Installed 
© Android SDK Platform-tools 23.0.1 Æ Installed 
~f Android SDK Build-tools 23.0.2 Not installed 
~ Android SDK Build-tools 23.0.1 Œ Installed 
4 Android SDK Build-tools 22.0.1 ~ Not installed 
~ Android SDK Build-tools 21.1.2 Not installed 
f° Android SDK Build-tools 20 Not installed 
+F Android SDK Build-tools 19.1 Not installed 

¥ [3 Tools (Preview Channel) 
+ Android SDK Platform-teols 23.1 rc] — Not installed 

YEZ Android 6.0 (API 23) 
[m Documentation for Android SDK 23 7 Not installed 

s im SDK Platform 23 1 E Update available: rev. 2 
Š Samples for SDK 23 2 Not installed 
Show: ~ Updates/New - Installed Select New or Updates Install 7 packages... 
Obsolete Deselect All Delete 7 packages... 


© + 


Done loading packages. 


Figure 4-18. SDK Manager 
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Launch SDK Manager using one of these options (one is from the command line and 
the other is from Android Studio): 


e Runthe android sdk command from the command line. It 
launches the SDK manager (the shell variables should be set so 
that the executables are in PATH). See https: //www.gitbook. 
com/book/machzqcq/ci-automation-mobileapps/edit for more 
information. 


e Click the SDK Manager icon in the Android Studio IDE, as shown 
in Figure 4-19. Figure 4-20 shows the result. 


Ei@appy|P HL PH È ? 


i | @ app x 


apply plugin: 'com.android.application' 
apply plugin: 'com.neenbedankt.android—apt ' 


android { 
compileSdkVersion 23 
buildToolsVersion "23.0.1" 


Figure 4-19. SDK Manager: Android Studio icon 

















F Appearance & Behavior > System Settings > Android SDK 
7 Appearance & Behavior Manager for the Android SOK and Tools used by Android Studia 
Appearance Android SDE Location: = {Users ponacharl |Library/Android/ sdk 
Menus and Toolbars 
7 System Settings 

















E $0 Tools | SOK Update Sites 





Each Android SDK Platform package includes the Android platform and sources pertaining to 


Passwords an AF level by default. Once installed, Android Studio will automatically check for updates. 
HTTP Proxy Check “show package details" to display individual SDK components. 
Updates Narie APiLevel Revision | Seamus 
Usage Statistics =| Android 6.0 (Marshmallow) 23 1 Update available 
Android 5.1 (Lollipop) 22 F4 Not installed 
Android 5.0 (Lollipop) 21 2 Not installed 
Notifications Android 4.4 (KitKat Wear) 20 Fi Mot installed 
Quick Lists Android 4.4 (KitKat) 19 4 Mot installed 
carmen Android 4,3 (elly Bean) 18 3 Mor ingtalleg 
Android 4,2 (elly Bean) 17 3 Mot ingtalbegd 
+ Editor Android 4.1 (elly Bean) 16 5 Not inestalbed 
Plugins Android 4.0.3 (ceCreamSandwich) 15 5 Mot installed 
b Build, Execution, Deployment Android 2.3.3 (Gingerbread) 10 Zz Mot installed 
i Android 2.2 (Froya) & 3 Not instalbed 
t Tools 
|_| Show Package Details 
Launch Standalone SOK Manager Preview packages available! Switch to Preview Channel to see them 
E | Cancel Apply OK | 


Figure 4-20. SDK Manager: Android Studio 
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Android Device Monitor 


Android Device Monitor is a standalone tool that provides a graphical user interface for 
several Android application debugging and analysis tools. 

Launch SDK Manager using one of these options (one is from the command line and 
the other is from Android Studio): 


e Run the monitor command from the command line. It launches 
the device monitor (shell variables should be set so that the 
executables are in PATH). See https: //www. gitbook.com/ 
book/machzqcq/ci-automation-mobileapps/edit for more 
information). 


e Click the Device Monitor icon in the Android Studio IDE, as 
shown in Figure 4-21. 


W app ~| P & T Fe = & aCe)? 


© app x 


apply plugin: ‘com.android.application' 
apply plugin: 'com.neenbedankt.android-apt' 


Figure 4-21. Device Monitor: Android Studio 


You can see the view when one device is connected in Figure 4-22. 


Žž Cab SBs2d Ga EG wi = 


Namg 
im” Nexus _4-00a219a0c09d05912 Online 


WD Logcat E Console %3 ) 


Figure 4-22. Device Monitor: device connected 
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CHAPTER 5 


Build the Android App 





The Android app can be built in debug or release mode—the difference being the 
keystore used to sign the app. If you build the app in release mode, the keystore will let 
you push to Google Play (assuming that the keystore associated with the user ID has 
already been registered through Google Play). 

Since the CI process requires building many times before being ready to be release, 
this chapter shows you how to build the app in debug mode and use the . apk that’s 
generated to pass it to the CI test automation step. 


The Android Build Process 


The following section contains a quick, high-level architecture overview of the Android 
app build process. Minor variations might exist in your specific projects. 


Overview 


Understanding the build process and being able to tweak it to suit your requirements is 
necessary once you have an MVP. I am a big fan of building the thin slice first, although 
there are many inefficiencies that can exist in the process. Once you see the result, the 
confidence and optimism will motivate you to go back and optimize the process. This 
is a good way to keep the stakeholders happy too, because it demonstrates continuous 
progress. Figure 5-1 shows an overview of the build process. 


Android Package (.apk) 
files arse ADE 
— = -| Signing DB Dewcte or 
uncompded Emulator 
faSouroes é 
AndroidManifestsxml m 





Figure 5-1. The Android build process 
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Another Perspective on the Build Process 


Consider another perspective with Gradle, which is a build and packaging tool that drives 
the build process. 


Figure 5-2 shows this build process. 


Install 





Figure 5-2. Android build process with Gradle 


Output of the Build Process 


After successfully building the app from the source code, you'll generally be interested in 
the .apk file, which is the app ready to be deployed. There are other folders created in the 
./app folder inside the project too. Figure 5-3 shows the folder contents for reference. 





ee 8 | 
i 
ona build bud i nermeciates loga 
(E) An My Fiaa Di build. gracte bund gradit DO aps 
Ai loud Drive B grade proguanirukes pro B imp 
® Aird TEKEE E gracie prepares Be 
ices E yidis 
yö; Applications |) ios E gradiew.bat 
EJ 2.48 2 jar E local popeta 
[i Documenta [pun shveitsn README mg 
© Downloads satinga pradie 
fi} pmachari 
Orit aa 
(2) Remote.. 
ured 
CI Device L 
E wmn 
M twromac 


Figure 5-3. Build output folders 
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Building from the Command Line 


You can build your Android app in two main ways: 


e IDEs such as Android Studio and Xamarin have a menu option for 
building the app once the project is imported. 


e Open a shell command and start calling Android build binaries 
(that are part of the SDK). 


Note Even the IDE calls into SDK binaries internally, but it is abstracted from the user, 
hence it seems easier. 


Gradle Tasks 


The Gradle task that you are interested in here is the one that enables you to build, 
compile, and output the .apk file. This falls under the category of Gradle tasks viz. build 


tasks. Figure 5-4 shows the tasks available from the gradle tasks command. Type gradle 
tasks in the command line and check out the output. It is not necessary to remember all 


the tasks; however, the more you practice the commands, the easier and faster it gets to 
script it out. 


Tnateall tasks 


Werification tasks 
Se rr 
ChETH Rint Ell lod a 
Connect tTedAnNd roidest 
connec teclheck uns g 1 

connected Me bygAndrogdTest lastalla and ru the tests fa ifbus 
devicedndroidvest Astal ñ hi Strumentat i tests ui 


Other tasks 
en 
jarGebugl larses 
jorhe lesget lagged 
LintVitalRe lease 


To se oll tosks ond more detail, gro 


To see more detail about o task, 





BUILD SUCCESSFUL 
Total time: 14.577 secs 


This build could be faster, please consider using the Gradle Beeman: Atips:/sdocs.gradle.org/2. Fiuserguide/gradledaceon, hial 


Figure 5-4. Gradle tasks 
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The Gradle Clean AssembleDebug Task 


The assembleDebug gradle task follows the build process, as mentioned in the 
architecture view, and the clean task cleans the build folder in the project. 

Figure 5-5 shows how the process would look when building an app with the 
following command: 


gradle clean assembleDebug 


Anyones-Mac-mini: pmachar \@Gradte clean assembleDebuy> 
:app: clean 


‘app:preBuild UP-TO-DATE 

:app:preDebugBuild UP-TO-DATE 

:app: checkDebugManifest 

-app:preReleaseBuild UP-TO-DATE 
:app:prepareComAndroidSupportAppcompatV72310Library 

:app: prepareComAndroidSupportDesign2310Library 

app: prepareComAndroidSupportMultidex1i@lLibrary 
:app:prepareComAndroidSupportRecyclerviewV72310Library 

:app: prepareComAndroidSupportSupportV42316Library 

app: prepareComFacebookAndroidFacebookAndroidSdk481Library 
:app:prepareComGoog LeAndroidGmsPlayServicesBase810Library 
:app: prepareComGoog LeAndroidGmsPlayServicesBasement810Library 
‘app: prepareComGoog lLeAndroidGmsPlayServicesIdentity810Library 
:app: prepareComSquareupLeakcanaryLeakcanaryAndroid131Library 
app: prepareComZendeskSdki1411Library 

:app: prepareDebugDependencies 

:app: compileDebugAidl 

-app: compileDebugRenderscript 

:app: generateDebugBuildConfig 

‘app: generateDebugAssets UP-TO-DATE 

:app:mergeDebugAssets 

‘app: generateDebugResValues UP-TO-DATE 

:app: generateDebugResources l 

> Building 63% > :app:mergeDebugResources 


Figure 5-5. Gradle clean assembleDebug 


A successful build should look like Figure 5-6. 


Note: Some input files use or override a deprecated APT. 
Note: Recompile with -Xlint:deprecation for details. 
Note: /Users/pracharl/gitprojects/hopster_android/app/src/main/sjava/com/inmar/android/app/hopster,/ request/p 
Note: Recompile with -xXlint:unchecked for details. 
sapp:compileDebugNdk UP-TO-DATE 

7app: compi leDebugSources 

:app:preDexDebug 

tapp:dexDebug 

:app: VvalidateDebugSigning 

zapp: packageDebug 

rapp:zipalignDebug 

Tapp: assembleDebug 


BUILD SUCCESSFUL > 


Total time: 1 mins 59.494 secs 


Figure 5-6. assembleDebug is successful 
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The .apk File in Debug Mode 


The output you are interested in is the .apk file, which is generally found in the relative 
folder path /app/build/outputs/apk. 


The debug app is typically named app-debug.apk and found in the folder structure 
shown in Figure 5-7. 
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(2) Remote. 
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m wrm 
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Figure 5-7. Apk debug file 


The .apk File in Release Mode 


The following command puts the .apk file in app/output/apk/release: 


./gradlew assembleRelease 


Note To build the app in release mode, you need to sign the app in release mode with 
keystore and private keys, as detailed at https: //developer.android.com/studio/ 
publish/app-signing.html. 
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Building from Android Studio 


This section explains how you can build the Android app from Android Studio IDE. 


Import the Project 


Figure 5-8 shows a sample Android project imported into Android Studio. You would 
simply click the Play button to build the Android app. 






HO er ALAARA ep USP RGR Fa PLAS 7? 


meld) Caepp) @ ttre 
v Clapp 


> © manifests 

> java 

> Cäres 

> Dāassets 

v (È Gradle Scripts 

(Ò build.gradle (Project 1) 
{Ò build.gradie (Module: app) 
[à gradle-wrapper.properties (Gradie Version) 
El proguard-rules.pro (ProGuard Rules for app) 
[ù gradle.properties (Project Properties) 
® settings.gradle (Project Settings) 
[À local.properties (SDK Location) 








! 
8 





Figure 5-8. Build the Android app in Android Studio 


The Play button will run the last run configuration. To see a list of all configurations, 
click the App dropdown, as shown in Figure 5-9. Choose Edit Configurations to see the 
screen in Figure 5-10. 


Alan i | 
o | ed ee ne eae, 





Edit Configurations... 
































Figure 5-9. Edit Configurations in Android Studio 
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Run Debug Configurations 


Name: app 


sabe 


Module: Cz app 

Package 

(*) Deploy default APK 

` Deploy custom artifact: 
L Do not deploy anything 
Activity 
Do not launch Activity 

(*) Launch default Activity 


| Launch: 


Target Device 
(*) Show chooser dialog 
Use same device for future launches 
USB device 
| Emulator 
Prefer Android Virtual Device: 


Figure 5-10. Edit Configuration screen in Android Studio 


Feel free to click each of the tabs and customize as needed. This example uses the 


defaults. 


Android Studio Views 


Android Studio provides different views for the project viz. 


Project 
Packages 
Scratches 
Android 
Project files 
Problems 
Production 


Tests 


BUILD THE ANDROID APP 


Emulator 


Logcat 
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The version of Android Studio that is stable and works with the code in this book is 
illustrated in Figure 5-11. 


Android 
FR Studio 


Android Studio 2.2.3 
Build #Al- 145.3537739, built on December 2, 2016 


JRE: 1.8.0_112-release-b05 x86_64 
JVM: OpenJDK 64-Bit Server VM by JetBrains s.r.o 





Figure 5-11. About Android Studio 


Project View 


Switch to the Project view so that you can see the changes as Android Studio builds the 
project. After you run the build configuration, the /app/build/outputs folder and the 
* apk file will appear, as shown in Figure 5-12. 


74 


CHAPTER 5 ™ BUILD THE ANDROID APP 





E ia Project x O$ p Pr 
aiv C android (~/gitprojects android 
a. 
mi > © .gradie 
m > D.idea 

v [app 
© 7 
= v O build 
3 > © generated 
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= > (Jtmp 
O > O sre 
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Ji app.iml 
> build.gradle 
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| v build 
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= >» © dex-cache 
= 
Ft l gradle_project_sync_data.bin 

H O gradle 
v =| .gitignore 
= (© build.gradle 
> radle.properties 
& lg prop 
mil =| gradlew 
we =| nradiow har 


Figure 5-12. Project view in Android Studio 


Note Since you configured Android Studio to use the System Gradle and System 
Android SDK (see the Android system setup section in Chapter 4), the resultant output 
should be the same as that of running it from the command line in the previous section. 


Building the Sample App 


This section shows you how to build an app from the source code. 


Source Code 


This section shows you how to use an app that’s already out there and very popular. 
The Sunshine app is used for tutorials, so let’s use it as your candidate. 


https://github.com/udacity/Sunshine-Version-2 
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Environment 


Assuming that you have set up the Android system environment described in Chapter 4, 
you Il see the environment shown in Figure 5-13. 


cat /opt/android-sdk-linux/platform-tools/source.properties | grep Pkg.Revision 
cat /opt/android-sdk-linux/tools/sources.properties | grep Pkg.Revision 





rootedf93eSda4dcc:~# cat /opt/android-sdk-Linux/platform-tools//source.properties | grep Pkg.Revision 
Pkg .Revision=23.1 

rootedfS3esda4dcc:~# cat /opt/android-sdk-Linux/tools/source.properties | grep Pkg.Revision 
Pkg.Revision=24,4.1 

rootedfS3eSds4dcc:~# gradle -w 


Build time: 2015-05-05 08:09:24 UTC 
Build number: none 


Revision: Scoc3bc20calc2810c7972643fle2d190fF2-943c 

Groovy: 2.3.10 

Ant: Apache Ant(T™4) version 1.9.4 compiled on April 29 2014 
JWH: 1.7.0_80 (Oracle Corporation 24.88-b11) 

OS: Linux 4.1.17-boot2docker amdé4 


Figure 5-13. Android build environment 


Note As mentioned on the git repo, sign up for the weather app key at http: // 
openweathermap.org/appid#use. Once you have the key, place it inside the ~/.gradle/ 
gradle.properties file. If the file doesn't exist, create it. 


Clone and Build 


To clone and build your sample app, cd into the repo and then run this command: 


gradle clean assembleDebug 


Note You can see a video of this process at https: //vimeo.com/154936765. 


Eventually, your successful build should look like Figure 5-14. 
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n edited 

tapp: processDebugMani fest 

:app: processDebugResources 

[app : generateDebugSources 

:app: compi LeDebugJava 

Note: Some input files use or override a deprecated API. 
Note: Recompile with -Xlint:deprecation for details. 
:app :preDexDebug 

:app: dexDebug 

:app:processDebugJovakes UP-TO-DATE 

:app: validateDebugSigning 


BUILD SUCCESSFUL 


Total time: 1 mins 1.511 secs 
This build could be faster, please consider using the Gradle Doemon: http://gradle.org/docs/2.4/userquide/gradle_daemon. html 


Figure 5-14. The sample app build 


Sample App: app-debug apk 
The app-debug.apk sample app is found in the app/build/outputs/apk folder, as shown 
in Figure 5-15. 


rootedf930Sda4dcc:~/Sunshine-Version-2# cd app/build/outputs/apk/ 
root@df9305d84dcc :~/Sunshine-Version-2/app/bui ld/outputs/apk# 11 
total 5856 

drwxr-xr-x 2 root root 4096 Feb 10 22:05 ./ 

drwxr-xr-x 3 root root 4996 Feb 10 22: 4 . f 

-rw-r--r-- 1 root root 2986111 Feb 1072 Ur ipp E : 
-rw-r--r-- 1 root root 2986491 Feb 10)22: a5 app-debug. apk 
-rw-r--r-- 1 root root 4704 Feb 10°RieO?-= R por 
root@df93eSda4dcc: ~/Sunshine-Version-2/app/bui Ld/outputs/apkf i 






er art. txt 


Figure 5-15. Sample app debug apk 


At this point, you can install the debug apk by following the instructions in Chapter 6. 


Note This source code is used only for demonstrating the build process. Be sure to use 
your own e-mail ID to create the API key. You need the proper API key to be able to launch 


the weather app. 


T 







CHAPTER 6 


Connect Android Target 





This chapter builds on Chapter 5, in which you learned how to successfully build an 
.apk file (either through the debug or release APK). Once the .apk file is ready on your 
filesystem, you have to ensure that you are connected to the target device/emulator 
where you intend to deploy the .apk file. 


Testing with Emulators versus Real Devices 


There is lots of information online about when to use emulators versus real devices. After 
working with mobile apps that utilize Android to the fullest extent, I have come to believe 
that real-device testing provides significantly higher confidence when releasing the app 
to production. 

You can start your app testing on an emulator, but because emulators cannot fully 
emulate the hardware, platform, and software conditions, your testing will be incomplete 
without testing on real devices too. 

For emulators, AVD (Android Virtual Device) Manager helps create virtual devices. 

For real devices, you have to purchase and maintain them or lease them from device 
clouds. 
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Using the Android Emulator 


The Android Emulator, as the name suggests, emulates an Android device. The utility 
strives to emulate the mobile hardware components, as well as the gestures (swipe, tap, 
etc.). You deploy your app into the emulator and then launch and test it as if it were 
running on a real device. 

Features that the emulator cannot imitate are geo-location, actual testing of cell 
towers, network bandwidth conditions, etc. 

For more information about using the Android Emulator, see https: //developer. 
android.com/studio/run/emulator.html. 


Hardware Acceleration 


When launching and configuring AVD, enabling hardware virtualization will greatly 
improve performance. You can enable this setting by choosing Emulated Performance: 
Graphics on the Verify Configuration page after you create the AVD. 

To enable hardware acceleration, choose GPU Emulation: True when configuring 
the AVD. 

Note that GPU Emulation and Snapshot: Enabled are mutually exclusive. 

The URL mentioned previously has more information and details and explains the 
various configurations possible. 


Create a New AVD 


After launching the AVD Manager, choose Create Virtual Device to open the screens 
shown in Figure 6-1. 
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Select Hardware 


KB Choose a device definition 














| Wear Nexus 6 5.96" 1440x2560 560dpi DaRi O 
Ww 19200x 
Nexus 4 4.7° 768x1280 xhcpi 
Galaxy Nexus 4.65° 720x1280 xhcpi 
5.4" FTA 5.4" 480x854 mdoi 
5.1" WVGA 5.1" 480x800 mdpi 
4.7" WXCA 47" 720x1280 xhepi 
4.65" 720p (Gala... 4.65" 720x1280 xhdpi 
[New Hardware Profile | | import Hardware Profiles | (5) Clone Device... 


(camel) Previous | SD Fan 





System Image 


Select a system image 





Release Name APi Level © ABI Target { 
Marshmallow 23 armeabl-v7a Android 6.0 Marshmallow 





Questions on API level? 
See the API level distribution chart 


|_| Show downloadable system images (S) 


( Cancel) | Previous ) Ginea | Finish — 


Figure 6-1. Android Virtual Device 
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Sample AVDs 


I created the sample AVDs shown in Figure 6-2 on my machine for this book. Feel free to 
name yours as you see fit. 


eoe _ Android Virtual Device Manager 





Your Virtual Devices 


fo Android Studia 


Tyee Nanig ReiHation AP Target CRU/AR | Sire on Disk Achons 
(Co) Nexus 4 ari 23 768 x 1280: xhdp 2300 Google APIs x86 1 GB prv 
[E] Nexus 4 API23 x86 768 x 1280: xhdp 230 Google APIs x56 1 GE bp es 


Figure 6-2. Sample virtual devices 


Learning Curve 


In the beginning stages, you should experiment with various combinations of AVDs. 
This will help you 


e Understand concepts and solidify your memory about the various 
configuration parameters available. 


e Fathom the breadth and depth of form factors and devices 
available in the market. 


e Give you context on this knowledge, so that during 
troubleshooting, you can connect the dots and find the root cause 
faster. 


Connecting the Android Device 


This section gets into the details and steps on how to connect an Android device as the 
target. 


ADB Is Your Friend 


When connecting real devices to an Android build machine for debugging purposes, 
ADB (Android Debug Bridge) is your friend. ADB was covered briefly in the “Tools to 
Know - ADB” section in Chapter 4, and it’s explored more in this section. 

ADB is a command-line utility included with Google’s Android SDK. ADB can 
control your device over USB from a computer, copy files back and forth, install and 
uninstall apps, run shell commands, and more. 
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ADB comes with Android SDK and is available in ANDROID HOME/platform-tools. 
You can check it by launching android sdk from the command line. On my machine, 
as you can see, it is already installed. (I make an assumption here that you have Android 
SDK installed and configured with PATH variables). 

You can verify that the Android SDK platform tools are installed by opening the SDK 
Manager, as shown in Figure 6-3. 


Appearance & Behavior > System Settings + Android SDK 
Manager for the Android SDK and Tools used by Android Studio 
Android SDK Location: = /Users/ pmacharl/Library/Android/sdk 


SDK Platforms SDK Update Sites 


Below are the available SDK developer tools. Once installed, Android Studio will automatically 
check for updates. Check "show package details" to display available versions of an SDK Tool. 









Name Version Status 
ergi 50) e Update Available: 23.0.2 
(Android SDK Tools 24.4.1 24.4.1 installed 
Android SDK Platfoum=+86ls 23.0.1 23.0.1 Update Available: 23.1.0 
Documentation for Android SDK 1 Not installed 
GPU Debugging tools 1.0.3 Not installed 
=| Android Support Repository, rev 24 24.0.0 Update Available: 25 
=| Android Support Library, rev 23.1 23.1.0 Update Available: 23.1.1 
Android Auto Desktop Head Unit emulator 1.1.0 Nort installed 
=| Google Play services, rev 27 27.0.0 Update Available: 29 
=| Google Repository, rev 22 22.0.0 Update Available: 24 
Google Play APK Expansion Library 3.0.0 Not installed 
Google Play Billing Library 5.0.0 Not installed 
Google Play Licensing Library 2.0.0 Not installed 
Android Auto AP! Simulators 1.0.0 Not installed 
Coogle Web Driver 2.0.0 Not installed 
=| Intel x86 Emulator Accelerator (HAXM installi$.4.0 Update Available: 6.0.1 


Show Package Details 


Figure 6-3. Android SDK Tools 


Enable USB Debug 


Before connecting your real device via USB to the computer, you have to enable the 
Developer options, since only then will ADB be able to talk to this device. 

To access these settings, open the Developer options in the system settings. On Android 
4.2 and higher, the Developer options screen is hidden by default. To make it visible, go to 
Settings > About Phone and click Build Number seven times. Return to the previous screen 
to find the Developer options at the bottom (see Figure 6-4). For more details about this 
process, see https: //developer.android.com/studio/run/device.html. 
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Your version of the image in Figure 6-4 might differ, depending on your device. 


Developer options 


DEBUGGING 


USB debugging 





Figure 6-4. USB Debug enable screen 


Connect the Device 


Now you can connect the device using a USB cable to your computer. Open a command 
prompt (or shell if you are on a Mac) and type: 


adb devices 


This command will list all the devices that are connected and have USB debugging 
enabled. 
If all goes well, you should see that your device is recognized, as shown in Figure 6-5. 


Anyones-Mac-mini:~ pmacharl$ adb devices 
List of devices attached 
90a219ae09005912 device 


Anyones-Mac-mini:~ pmacharl$ 


Figure 6-5. adb devices output 


Troubleshooting Tips 


Sometimes, you might see unauthorized instead of the device listed, as shown in the 
following code. The reason this generally happens is because of an improper handshake 
between the device and the Mac. The RSA fingerprint should be generated and the 

Mac should have the public key. You should see a pop-up on the device to accept the 
connection. The effect of unauthorized is that any subsequent commands will throw an 
error, such as the $ADB_VENDOR_KEYS not being set: 


pradeep@seleniumframework.com: $ adb devices List of devices attached 
209c6111 unauthorized 

pradeep@seleniumframework.com: $ adb tcpip 5555 error: device unauthorized 
This adbd's $ADB_VENDOR_KEYS is not set; try ‘adb kill-server' if that seems 
wrong. Otherwise check for a confirmation dialog on your device 
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To solve this unauthorized problem, delete the files adbkey , adbkey. pub from all of 
these locations. (It is okay to do this, because the files are generated every time the device 
is connected if one is not found). 


~/.android 
~/ .AndroidStudioxX/.android 


After deleting these files, restart ADB with adb kill-server and then adb start- 
server. At this point, you should see a pop-up on the device to accept the connection. 
Click Yes. For full details of this problem, see http: //forum. xda-developers. com/ 
verizon-lg-g3/help/unable-to-access-adb-t2830087. 


Debugging the WiFI 


This section is applicable only if you are interested in exploring with WiFi. As a beginner, 
a USB wired connection will get you the MVP faster. 

It is possible to connect an Android device over WiFi. While the experience is not as 
smooth as connecting to a USB cable, understanding the fundamentals of networking 
concepts helps you debug and troubleshoot any connection issues. 

I find these two links to be helpful for first timers: 


http: //codetheory. in/android-debug -bridge-adb- 
wireless-debugging-over-wi-fi/ 


https: //stackoverf low. com/questions/2604727/how-can- 
i-connect-to-android-with-adb-over-tcp 


ADB Commands 


adb commands are quite helpful in this context. 
There are many options for adb. Simply type adb in the command line to see the 
options. A few I tried were: 


adb get-serialno adb get-devpath 


adb get-state (prints: offline | bootloader | device) adb usb (back to 
listening on usb) 


adb tcp (listen on tcp protocol) 
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All these options can also be seen on the command line by typing adb help, as 
shown in Figure 6-6. 


adh disahble-verity = disable dn-verity checking on USERDERUG builds 

adb enable-verity = re-enable de-verity checking on USERDERUG huilds 

adb keygen <file> =- generate adb publiceprivate key. The private key is stored in ¢file>, 
and the public key is stored in ¢file>.pub. Any existing Files 
are overwritten. 

adb help = show this help mercrage 

adb version — how vertion nun 

cript ing: 


block until device is online 
ensure that there is a server running 

the server if it is running 
prints: offline | bootloader | device 
adb gqet-cerialne prints: ¢cerial—nunber> 
adhb qet—dewpath prints: ¢device—path> 
adb remount — renounts the ‘eycten, “vendor Cif present) and soem Cif present? partitione on the 
adb reboot [boot loader! recovery] 

- reboots the device, optionally into the bootloader or recovery program. 

adb reboot side load - reboots the device inte the cideload mode in recovery program tadb root required?. 
adh reboot cide load—auto—-reboot 
= reboots into the sideload node, then reboots automatically after the sideload regar 
reboots the device into the boot loader 


adb wait-for-—device 
adb start-corver 
adb kill-corver 

adb get-state 


adb reboot-boot loader = 
adhb root -= restarts the adhd daenon with root perniss ions 

adb unroot = restarts the adhd daemon without root rics ions 

adhb usb = restarts the adhd daenon listening on USE 

adb tepip ¢port > = restarts the adhd daemon listening on TCP on the specified port 
etwork ime = 

adb ppp ¢tty? [parameters | Run PPP over USH. 

Hote: you should not automatically start a PPP connect ion. 

{tty? refers to the tty For PPP strean. Eg. dev? “dev/onap_csnmi_ttyl 

[pParaneters | Eq. defaultroute debug dunp local notty usepeeridns 


db sync motes: adb symc [| directory» | 
$ loca ldir? can be interpreted in several ways: 


If ¢directory? is not specified, ¢systen, ‘vendor Lif present}, “orem Lif present? and “data partitions will be wu 


IF it is “systen",. “vendor, “ = 


is updated. 


pen" or "data", only the corresponding partition 


emu ironmental variables = 
a 


Figure 6-6. ADB help 


Connect Over WiFi 


If the mobile device and machine are in the same network (the adb client has to 
communicate with the adb daemon running on mobile devices), then the experience 
will be much easier. Ensure that both of them are connected to the same WiFi connection 
before following these steps. 


1. Manually discover the IP address of the device by navigating 
to Settings > About Phone > Status. 


2. Auto discover the IP address with the adb shell.... command. 
Any devices that have adbd (the adb daemon) listening will 
show up here. (You can also check if the Android debug 
interface is enabled on your device by going to Settings 
» Developer Options > Debugging section > Android 
Debugging.) 


C:\Users\pmacharl>adb tcpip 5555 
C:\Users\pmacharl>adb devices 


List of devices attached 
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C:\Users\pmacharl>adb connect 192.168.1.141:5555 connected to 
192.168.1.141:5555 C:\Users\pmacharl>adb devices 


List of devices attached 192.168.1.141:5555 device 
C:\Users\pmacharl>adb shell ip -f inet addr show wlano 
wlanO: <BROADCAST ,MULTICAST,UP,LOWER UP> mtu 1500 qdisc mq state UP glen 
1000 inet 192.168.1.141/24 brd 192.168.1.255 scope global wlano 
C:\Users\pmacharl>adb usb 
restarting in USB mode 
C:\Users\pmacharl>adb devices 
List of devices attached 

You can also choose to make adb listen on another port, such as 4455. 

As you can see in the following code, first the device was connected to the PC/Mac 
in both USB and TCP/IP (network) mode, hence, there were two rows listed. But when I 
unplugged the USB cable, only the TCP/IP mode was enabled and hence only one row is 
shown. 
C:\Users\pmacharl>adb tcpip 4455 
restarting in TCP mode port: 4455 
C:\Users\pmacharl>adb shell ip -f inet addr show wlano 
wlanO: <BROADCAST ,MULTICAST,UP,LOWER UP> mtu 1500 qdisc mq state UP glen 
1000 inet 192.168.1.141/24 brd 192.168.1.255 scope global wlano 
C:\Users\pmacharl>adb connect 192.168.1.141:5555 unable to connect to 
192.168.1.141:5555 C:\Users\pmacharl>adb connect 192.168.1.141:4455 
connected to 192.168.1.141:4455 C:\Users\pmacharl>adb devices 


List of devices attached 209c6111 device 192.168.1.141:4455 device 


C:\Users\pmacharl>adb devices List of devices attached 192.168.1.141:4455 
device 


Remote Debug Chrome 


This section is more useful when you start writing automation scripts and have to identify 
UI element locators; otherwise, the USB wired connection will help with MVP. 
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To use remote debugging, you need the following: 
e Chrome (version 32) or later installed on your machine 
e Android device running Android 4.4+ 
e USB debugging enabled 
e USB cable 


Once the basic things are in place, connect your device to the machine using a USB 
cable. Launch Chrome and open a tab with target chrome: //inspect. The Chrome screen 
should resemble Figure 


ad O | chrome /inspect#devices 
DevTools Devices 
| Devices Liecover USE Sees Poet forwarding... 
ho devices detected. Please read thea ramola dabugging documentaiion to vanty your device is enabled for USB debugging. 


Allow USB debugging? 


The computer's RSA key fingerprint is: 
51:CF:7E:2C:94:A1:13:1D:E7:A9:3F:55:CA:65:D?:C5 


Always allow from this computer 


Cancel 





Figure 6-7. Chrome connect 
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Once you click OK, your device will show up in the browser tab, as shown in 
Figure 6-8. 


E G chrome:/ /inspect/#devices — 
DevTools Devices 
| Devices Discover USB devices | Port forwarding... 
Nexus 5 #mamonsuses 
Chrome Beta (39.0.2171.44) Open 


E Chrome tor Android 
inspeci locus tab reload close 


Chrome (38.0.2125.114) | Open 


{Y Web Starter Kit — Web Fundamentals 
inspect focus tab reload close 


ig Android Developers 
Inspect locus lab reload close 


8 HIMLS Rocks - A resource for open web HIMLS developers 
inspect focustab reload close 


ana naur me ee a 


D imei es Gi ee eii ie A lS 





Figure 6-8. Device connected to Chrome 
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You can also use the screencast option by clicking the Screencast icon in the upper- 
right corner of your remote debugging DevTools window. See Figure 6-9. 


Developer Tools - developers.google.com/web/starter-kit/ Nái 
Q |Elements| Network Sources Timeline Profiles Resources Audits Console kE æ [0] 


ES a Styles | Computed Event Listeners » 
wehtml class=" js is-touch"> 


> <head>..</head> element.style { + oh 
v<body class="page—-starter—-kit" itemscope |+ 
itemtvpe="htto: //schema.ora/Article"> develaners_annole.coms 


Figure 6-9. Screencast option 
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Deploy or Install 
Android App 





In Chapters 5 and 6, you learned that the output of the build is the .apk file and the target 
where you want to install the .apk file has to be connected first. In this chapter, you will 
learn how to deploy the Android app to the target device that is connected to the Mac. 


Connect and Identify the Target 


You can identify the emulators or devices that are connected to the machine using these 
commands: 


Anyones-mac-mini: pmacharl$ adb devices 
List of devices attached 
emulator-5554 device 
emulator-5556 device 
emulator-5558 device 
00a219ae09d05912 device 
Each line after the List of devices attached line represents either an emulator 


or a device. Emulator has the word emulator-xx prefixed and the device has a serial 
number. 


Direct Commands to Target 


adb can direct commands to a specific target using this syntax: 
adb -s <serial number> <command> 


If there is only one device connected, use the -d switch. Similarly, if there is only one 
emulator connected, use the -e switch. 
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To be on the safe side, using the -s switch will ensure that there is only one matched 
target. 


Install on the Emulator 


Install on emulator-5554: 


adb -s emulator-5556 install myapp.apk 


Install on Real Device 


Install on device: 


adb -s 00a219ae09d05912 install myapp.apk 


Command-Line Demonstration 


The commands are shown as follows. 


adb -s <device_id> install app-debug.apk 
adb kill-server 

adb start-server 

adb devices 


Sometimes, if there is too much delay (more than 5 min), you might have to kill adb 
and start over again. Most of the time, you don’t have to do that, except if you leave the 
device running for a week or so. That should anyways be handled as part of your mobile 
device lab set up, where you refresh/reset the adb connections at a certain interval. 
Figure 7-1 shows the demo. 
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Anyones-—Mac-mini:apk pmacharl$ ls -1l 

total 52608 

—fw-r--r-—- 1 pmacharl staff 13465517 Dec 20 69:16 app-debug-unaligned. apk 
-rw-r--r-- 1 pmacharl staff 13466417 Dec 20 09:16 app-debug.apk 
Anyones—Mac-mini:apk pmacharl$ adb devices 

List of devices attached 

00a219ae090d05912 device 


Anyones-Mac-mini:apk pmacharl$ adb -s 0@a219ae09d05912 install app-—debug.apk 
wie 

Anyones-Mac-mini:apk pmacharl$ adb -s 00a219ae09d05912 install app-debug.apk 
“ia © 

Anyones—Mac-mini:apk pmacharl$ adb kill-server 

Anyones-Mac-mini:apk pmacharl$ adb start-server 

+ daemon not running. starting it now on port 5037 * 

* daemon started successfully * 

Anyones—Mac-mini:apk pmacharl$ adb devices 

List of devices attached 

0@0a219ae09005912 device 


Anyones-—Mac-mini:apk pmacharl$ adb -s 90a219ae09d05912 install app-—debug.apk 
3175 KB/s (13466422 bytes in 4.1415) 
pkg: /data/local/tmp/app-—debug. apk 


Success 
Anyones—Mac-mini:apk pmacharls Į 


Figure 7-1. adb commands demo 


Android Studio Demonstration 


If you decided to use Android Studio, click the Run button next to the app icon. 
The dialog box shown in Figure 7-2 should appear. 
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le 
O © Choose Device 
‘| 


(*) Choose a running device 
Device Serial Number State Compati... 





LGE Nexus 4 Android 4.2.2 (API 17) \00a219ae09005912 Online 


eee Gas aa 


Launch emulator 


Android virtual device Nexus 4 API 23 -A li i | 


| Use same device for future launches 


ST rT ad | 


© nel) 


Figure 7-2. Android Studio app installation 


Click OK. You will be able to see the exact commands in the terminal, as shown in 
Figure 7-3. Copy the .apk file to the /data/* folder in the device and then install the app. 
Automatically attach the debugger to the running process and so on. The output should 
look similar to Figure 7-3. You have plenty of information here to munge, like logcat tab, 
adb log files, and so on. 


No files are open 


s Search Everywhere with Double © 
+ Open a file by name with $30 

. Open Recent Files with RE 

a Open Navigation Bar with SET 





i] Grad properties 


wadiew 
gradiew. bat = Drag and Drop Mels) here from Finder 
Foor ict G- | 
È hogater_andecdd 
Ca 
Andion Ù- i 
E LCE Nexus 4 Android 4.2.2 API 17) 4 com ener ard raid app 
DI akg ADE =" gg Memory =" jeru = Lig level Verbose $ $ Show only selected application 
Tis28 Lad Tia 1563-2546 C08. mar: android ape. Lidalvikve-heae: Grow heap (frog cose}! te 16.25488 for 1402016-byte allocation 
12-28 Irii. Mee 1564-25458 C08. Ima ond roid. app. Bidalvikvm: GL_POR_ALLON freed OK, BY Tiree 16627/17525; pow Lins, total line 
12-20 DPiadi iT Et 1563-2544 08, imar. android. opp. Bidalvikvs GO _FOR_ALLGt freed <1, 3% frer TGS LBSTIR, Bowes Die, totol Ihe 
12-20 Lead: 13.7TTS 1563-7538) com. irmar.android. app. Oyfdalvikve: GOLFOR_LALLOC freed LITE, Su free 1B41LBR/20320K, pasted Aas, total tien 


Figure 7-3. Installation console 


At this point, you should be able to see activity on your mobile device and the app 
should be launched with the home activity screen displayed. 
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CHAPTER 8 


Working with Appium 


This chapter covers more about the Appium tool/framework/ library and explains the 
what, why and how, so that you will be ready to automate the testing in Chapter 9. For 
detailed information, you can visit Appium's web site at http: //appium. io/. 


Why Appium? 


This section explains the reasons behind why Appium is my choice for an automated 
testing platform. You’ve looked at Appium a little in Chapter 2, and this chapter gets into 
much more detail. 


e WebDriver JSON wire protocol: Appium is designed based on 
the WebDriver protocol, which is set to become a WSC protocol 
and aligns with the various frameworks that exist with Selenium. 


e Multiple programming languages: Since WebDriver is HTTP 
over wire, a WebDriver compatible language can work with 
Appium. Hence, much like Selenium, Appium client libraries exist 
for Ruby, Java, Python, PHP, JavaScript, and so on. Even witha 
newer programming language like Go, you have to implement the 
contract as defined by WebDriver protocol and it works. 


e Release app vs. Debug app: While unit testing tests the paths 
having access to source code, the end user experience has to be 
tested with a release app build. Appium works on release app 
builds, which means you'll have relatively greater confidence in 
integration and end user test automation scenarios. 


e Open source: Since it is open source, there is a huge community 
supporting and resolving issues. While some might consider 
this tough initially, open source with crowd sourcing is the way 
the software world is moving. It makes sense to invest in such 
technologies that are flexible and put the decision power in the 
hands of the developer. 
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Appium Concepts 


In the next few sections, you'll learn about the fundamental architectural paradigms 

on which Appium is built. As you read these sections, you might not be surprised to 

find a strong correlation between Selenium Web Driver Architecture and Appium (i.e., 
assuming that you are not just a user of Selenium library, but at some point had to dig 
deep enough into the Selenium source code or its architecture). It is not a prerequisite 
to understand this analogy, but it will help you when debugging intricate details. (For 
example, try capturing the remote IP address of the node on which the test is executing.) 


Client/Server Architecture 


Appium is at its heart a web server that exposes a REST API. It receives connections 

from a client, listens for commands, executes those commands on a mobile device, and 
responds with an HTTP response representing the result of the command execution. The 
fact that you have a client/server architecture leads to a lot of possibilities. You can write 
your test code in any language that has a HTTP client API, but it is easier to use one of the 
Appium client libraries. You can put the server on a different machine than your tests are 
running on. You can write test code and rely on a cloud services like Sauce Labs to receive 
and interpret the commands. 


Session 


Automation is always performed in the context of a session. Clients initiate a session with 
a server in ways specific to each library, but they all end up sending a POST /session 
request to the server, with a JSON object called the “desired capabilities” object. At this 
point, the server will start the automation session and respond with a session ID, which is 
used for sending additional commands. 


Desired Capabilities 


Desired capabilities are a set of keys and values (i.e., a map or hash) sent to the Appium 
server to tell it what kind of automation session you're interested in starting up. There are 
also various capabilities that can modify the behavior of the server during automation. 
For example, you might set the platformName capability to Android to tell Appium that 
you want an Android session. Or you might set the chromeAllowPopups capability to 

true in order to ensure that, during a Safari automation session, you re allowed to use 
JavaScript to open new windows. See the capabilities document for the complete list of 
capabilities available for Appium. 


96 


CHAPTER 8 > WORKING WITH APPIUM 


Appium Server 


Appium is a server written in Node.js. It can be built and installed from source or installed 
directly from NPM. 


Appium Clients 


There are client libraries (in Java, Ruby, Python, PHP, JavaScript, and C#) that support 
Appium’s extensions to the WebDriver protocol. When using Appium, you might want to 
use these client libraries instead of your regular WebDriver client because the community 
has already implemented most of the calls. You can view the full list of libraries at 
https://github.com/appium/appium/blob/master/docs/en/about-appium/appium- 
clients.md. 


Appium.app and Appium.exe 


These GUI wrappers around the Appium server can be downloaded. These come 
bundled with everything required to run the Appium server, so you don’t need to worry 
about Node. They also come with an Inspector, which enables you to check out the 
hierarchy of your app. This can come in handy when writing tests. 


Appium Design 


Appium uses vendor-provided automation frameworks under the hood. That way, you 
don’t need to compile any Appium-specific or third-party code or frameworks in your 
app. This means you're testing the same app you're shipping. The vendor-provided 
frameworks are: 


e iOS: Apple’s UIAutomation 
e Android 4.2+: Google’s UiAutomator 
e Android 2.3+: Google’s Instrumentation 


Instrumentation support is provided by bundling a separate project, called 
Selendroid. More information can be found at appium. io. 
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The architecture diagram shown in Figure 8-1 depicts the control flow of the 
automated test script actions. 


Appium Architecture - Android 


eee Android phone, tablet, 
| Android UI EEA E A 
Webdriver compatible a adb et 
chent library. Selenium, Appium Server 
Appium et al. 
(ruby, python, java etc.) 


EON over 1 
a= 9- = 
Sener 
erred Pusey 


Nadve Commands 





Figure 8-1. Appium Android architecture 


1. The left side of the blue dotted line is the users’ concern. 
2. The right side of the blue dotted line is abstracted by Appium. 


3. The Appium server talks to the necessary native libraries 
of Android (adb, UI Automator, etc.) and ensures that the 
commands are passed to the target device/emulator. 


4. adb is part of Android SDK and hence the adb server keeps 
running inside the device and listens to the commands sent 
by Appium server. 


9. On the host machine that the target device is connected to, 
adb-server communicates with adbd (adb daemon) on either 
the emulator or on the real device. 
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6. The Appium server communicates with the adb server 
through the adb client that comes as part of the Android 
SDK. (None of this is mentioned in the architecture owing to 
granular details.) 


7. The Appium server also talks to the UI Automator using its 
internal bootstrap npm module. Prior to Android 4.2, Appium 
used Selendroid to communicate with the UI Automator. 
Hence, when you connect to an Android device that’s older 
(i.e., older than the 4.2 SDK), you have to start the Appium 
server by specifying --selendroid-port. 


Appium Android 


This chapter shows you how to work with a test automation framework that combines 
Cucumber, Ruby, and Appium and helps you write automation test cases. 

This chapter follows the ATDD (acceptance test driven development) methodology 
and hence first writes features and scenarios and subsequently writes the code-behind. 


Appium 


On the client side, you will use the appium_1ib client library and the exposed APIs. It is 
also possible to use the Selenium WebDriver and create desired capabilities that specify 
Appium as the WebDriver. Having a background on the WebDriver protocol will greatly 
help you understand the Appium client library. 


Installing the Appium Server 


In this section, you install the Appium server and navigate some screens (the default 
screens and Android-specific ones). 


Download and Install the Appium Server 


Follow the instructions on the Appium home page at http: //appium.io/. (You can see 
that it is a Node.js server, and hence you can start the server from the command line. 
However, to keep it simple initially, I just download the . dmg file and double-click to 
install and start. Eventually with CI alignment, you will want to go with the Node.js server, 
though. Click the Launch button. 
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GUI Start Android Mode 


Figure 8-2 shows Appium Android mode. 





SP!ALS’isa * é @ K ¥F so 


| debug-log-spacing —automation-name “Appium” —platform-name “Android” —platform- 
| version "5.1" =—-full-reset 


| /Users/pmacharl/.profile: line 2: usr/libexec/java_home: No such file or directory 


info: Welcome to Appium v1.4.13 (REV 88e67ce987d78ce44de252219e07dc176a3511c2) 


info: Appium REST http interface listener started on 0.6.0.0:4723 
info: [debug] Non-default server args: 


| {"fullReset":true,"platformName": "Android" ,"“platformVersion":"5.1",“automationName 
|":"Appium" scala pyle t": 7200, "“debugLogSpacing": true} 


info: Console Loglevel: debug 
info: —> GET /wd/hub/status {} 


info: [debug l l to client with success: {"status":0, "value": {"build": 
| {"version":"1. B rel : } 37d 


4. " "revision" :"88e67ce987d78ce44de252219e07dc176a3511c2"}}} 


info: <— GET /wd/hub/status 20@ 11.730 ms - 105 {"status":0,"value":{"build": 
{“version":"1.4.13","revision":"88e67ce987d78ce44de252219e07dc176a3511c2"}}} 


info: —> GET /wd/hub/status {} 


info: [debug] Responding to client with success: {"status":0,"value":{"build": 
{"“version":"1.4.13", "revision" :"88e67ce987d78ce44de252219e07dc176a3511c2"}}} 


info: <— GET /wd/hub/status 200 3.580 ms - 105 {"status":0,"value":{"build": 
{“version":"1.4.13","revision" :"88e67ce987d78ce44de252219e07dc176a3511c2"}}} 


Figure 8-2. Appium Android mode 
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Some notes about the Appium server: 


e The Appium server is started in Android mode (note that the 
radio button for Android is checked). 


e By default, the Appium server listens on port : 4723 on all network 
interfaces (0.0.0.0). 


e Itis assumed that you have completed the Android System setup 
section in Chapter 1 (the Android SDK should be available in the 
PATH, including its Android tools). 


e The Appium server version, as you can see, is 1.4.13. 


Appium Server Configuration 


Now that you have installed the Appium server, it’s time to learn about the configuration 
options that Appium provides. I do not go into all the options, but instead focus on the 
ones that matter to the test automation scripts and the debugging context discussed in 
this book. 


Appium Doctor 


The mobile environment set up is a little more complex than the web development 
environment because of the dependencies on various SDKs, emulator/simulators, 

and their versions. The permutations and combinations increase and there are often 
questions that come up for an automation engineer in terms of application compatibility. 
Such questions include: 


e What version of Android SDK is running? 
e What versions of emulators/simulators are running? 
e What mobile devices are attached? 


As you can see, setting up a build environment is dependent on how much clarity 
you have on these questions. You also need to understand any “backward compatibility” 
vs. “forward compatibility” issues. Unless you are clear about these issues, you are 
not sure what you are testing. Sure, you can go ahead and test on the developer’s 
environment. But that is not guaranteed to be the same on another developer’s machine. 
Hence, certifying/validating and running the automation tests are heavily dependent on 
understanding the environment. 
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For the Appium environment, these settings are necessary and the Appium server 
can set most of those values. To be precise, it is always advisable to run the Appium 
Doctor, which does basic checks on the availability of the Android environment. (Clicking 
the stethoscope icon will run Appium Doctor from the UI.) See Figure 8-3. 


Last login: Wed Oct 7 22:51:24 on ttys6@2 = 
l Anonai pmacharls '/Applications/Appium.app/Contents/Resources/node/b 
in/node' '/Applications/Appium.app/Contents/Resources/node_modules/appium/bin/ap 
pium-doctor.js' 

Running i0S Checks | 


J 


TALA 


Running Android Checks | 
a 


, # 


a, & & & 


F 1 


; Anyones—Mac-—mini:~ pmacharl$ 


‘ae Mm Ra Mike A PP HR PR aa T oe Ae vi Ff Phat hi Y wean wll 


Figure 8-3. Appium Doctor 
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Developer Mode 


Because of the many incompatibilities between items in the tuple (such as OS, platform 
SDKs, Appium server versions, etc.), you should get comfortable playing and installing 
multiple Appium server versions. The developer mode enables you to use the Appium 
source, as shown in Figure 8-4. 


JAppiun 


e Bite a Tf E ren * a Launch 





Developer Settings 


F i : s fuer localbimn nodo 


(Usas pmacharlditprojects'app um 


ees ae Pe es ee E ee eal 


„Bocu les) app lun soins’ a 


Figure 8-4. Appium developer mode 


In this case, the Appium source was downloaded to /Users/pmacharl/gitprojects/ 
appium. 


Server Command Line 


While GUI is one way to start the Appium server, for CI, you need to be able to start 

the server from the command line. cmd is also necessary so that you can code away the 
process of starting the server. It’s also important to be able to programmatically (through 
Bash or PowerShell scripts) kick off the server (such as through a Jenkins CI job). 
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You can start the command line server by typing appium, as shown in Figure 8-5. 


Aye O06 -Mac-9.54' 09h prachartt app. at 
‘ 


welcome to Appius wl. 4.11 (REV Oc fEIIL (OPED SelE1e delti c *Gcbecet*occe! 

Appius ERST mito irtertace sterner tarten on 0.0.0. 074775 

Console Logleve ced 

[ceùug] Accponding to client with seccess: ("otetus™ iO, "rolun": ("build"s ("versioni "1.4. LI", revision" i Oc PO 311100c5 002 10l den ciGd Socet bct") 


Figure 8-5. Command line start 


You can also start the command line server from source code. 
Navigate to ~/appium/bin and type ./appium. js, as shown in Figure 8-6. 


Anyones-Mac-mini:bin pmacharl$ pwd 

fUsers/pmacharl/oitprojects/appium/bin 

Anyones-—Mac-mini:bin pmacharl$ ./appium.js 

info: Welcome to Appium v1.4.13 (REV 8Be67ce987d78ce44de252219e87dc176a3511c2) 
info: Appium REST http interface Listener started on 0.80.0.0:4723 

info: Console Loglevel: debug 


Figure 8-6. Start Appium from the source code 


Appium Android Settings 


Appium server provides many settings for Android. It is beyond the scope of this book 
to go into each field; however, I want to mention that you can set each of the field values 


programmatically (which you will see during scripting). Try playing with different settings 
to get comfortable. See Figure 8-7. 


i i = Ë 5 
a WETE 
Basic 86 Advanced A 
Applicat ree" ~jdebug—Log—spac in —avtonation-nane 
EAN r —p lat forn-version 5.18 —full-reset 
App aon Ja e pracha pt perc ee ee ee 
iar Libexec/java_home: No such file or directory 
Package w | 
7 ch179bdf3S2d3c62d3A tasah A M01 Ma) 
Wail for Package 
listener started on 8.8.8.8:4773 
Laung Actie “ ši 
a iani indroid”,"“platformVersion":"5.1", “sutomat borane 
Wait for Activity “ i7200, “debuglogipociag": true} 
Use Browser 7 Full Romet Mo Rosol ~ Siop or Araci 
meni Aachen ardid. mient-acton/l tent Catagory android inieni cates ot with success: (“status :0," valus" :{"puild": 
= ar K | MibdHI5 Pd ob I00S fh FbSTA4G1S tfia" } Y 
rtemt F je cee 20000 migni Br Rit ini | 
LIH ns = 104 (“states":6,"value" build": 
Lauacs Dewees SbiAS5 PS ch7 098 Ib II649 12 38d 199428" | 
Launs AWD Cevisa Aged Threat (3 
Ana imania | with success: (“stetus" r0; "value": {"build"; 
x d NibiASS Pe cb 3098 anahat aa" hY 
Capabilities LITA ma =- 104 ("states i0, wa lue": {"bui ld": 
$ Mbit ch2d9G febr } }) 
Mattorm Mame Areia i Automaten Name Åna w | 
Plata Wiert Buel (A Lēwel oad ta 


Javice Name ii 


Figure 8-7. Appium Android settings 
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The app path can point to an .apk file, for example. 

Similarly in Advanced settings, you can point the Android SDK to a specific location 
instead of the default, which Appium server might look to. This way, you are sure to use only 
one version of Android SDK and can make updates to that version only. See Figure 8-8. 


Android Settings 


Basic Agwoncod 


ADVIMCSC 
+ Anctoid SDK Path AUsers/omacharlLibrary(Andrmoed'scdk 
Coverage (lass 
Boostran Part 0 Selandmevd Pert C 


Lromeconher Fath 


Korkoa Stites 
Jeo Custom Settings 
Keyeior Paih (Uses pmachanl android debugkey 
Keystore Password 


Figure 8-8. Appium Android Advanced settings 


Chromedriver Pert | a: - 


® é @ Æ Cf Launch 


rea" —debug-Log-spacing —autonstion—-neme 
—pLatform-version "5.1" —full-reset 


isr/Libexec/java_home: No such file or directory 
0$1790d835203C02098 fa58b324491230d 19342a) 


istener started on 8.8.8.8: 4723 

mgs: 
\ndroid","platformVersion"i "5.1", "outomat ionom: 
(TAA " debugLogspecing": true} 

| 
(with success: {["status":0, "valus": ("boi td": 
"$bd8352d3¢620987 5303294912300 f934Z0"}+} 


1.134 mo = 164 {["ytotus":0; "volue": ("build: 
MbdbIS2d3c620981 a58b52449123ed f9342a"}+} 








with success: {" status" i0, “value: (“bulld: 
gbi dah aaah od POS4 ta") }} 


(O74 ms = 10H ("status ’:6, "value" :{"build™: 
ibdig5 dJc dð aSob sesso 23edfos42a"}) 
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Appium Server Settings 


Finally, the Appium server itself has settings that can be changed, as shown in Figure 8-9. 


Genoral Settings r.i y $ | Launch 


Server Addresa: 0000 Port 2723 











-spacing —auteration-nane 
on "5.1" —full-reset 
hone: No such file or directory 


2d90fa50bI32449127300 93420] 
1 7200 a 


n 0.0.0.04723 


roVersion®:"5. 1", “automat Lonate 
acing’: true} 


'status" r, "value" :{"build": 
asetz gledi Haa" }}} 
'gtatus" 2:0, "valve": {"build": 
a58b 3744917 df 3470" } bh 


Maximum Log Length 200000 Log Level 


g To ViebH 
‘status":8, "value": {*build": 
05863244912 30d 193420") H} 


Brenden’ Wari Gl ies 


tatus’:6, "value" "build": 
faS8b324491230df9342a")}} 


Figure 8-9. Appium server settings 


Note All of these settings are also available as server arguments and you can access 
them by typing appium -- help at the command line. 


The information you've read at this point might seem overwhelming with respect 
to the number of options available; however, it will become easier once you start coding 
away all these complexities. That is one of benefits of CI—it helps automate away 
mundane and repetitive tasks. 


Inspecting an App 


Much like how you identify elements of DOM for a web page using Selenium, you follow 
a similar process for an app. That is, you need to first uniquely identify the locator for an 
element, before performing an action on it. There are various strategies for that. To geta 
refresher, check out http://www. seleniumframework.com/basic-tutorial/html-dom/. 
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Most of the UI automation tools and web scrapers have an element identification 
strategy and knowing it helps you automate actions. It is a good idea to spend some 
time inspecting your mobile app’s “view” as it gets rendered onto the screen. More 
importantly, understanding the HTML representation and various attributes will help you 
write automation scripts faster. 

This is very similar to using Chrome’s dev tools (inspect element), Firefox Inspect 
Element/Firepath/Firebug, or IE Developer tools. While writing web application 
automation scripts using Selenium, it is essential that you use these developer tools. 


Figure 8-10 is an illustration. 


€ C www. seleniumframework.com/basic-tutorial /humi-corm 


Q Research Trango Park. Raleigh. NC 27007 E +1 (347) 466-7432 a support @seloniunframework com 


HOME TUTORIALS PRACTICE SELENIUM CUCUMBER FORUMS ABOUT 





UNDERSTANDING HTML DOM 


BASIC TUTORIAL 
Pre-requisites: 





Figure 8-10. DOM (document object model) 


Appium Ruby Console 


The Appium Ruby console (ARC) is a handy tool for quickly looking at the screen HTML. 
Follow these steps to start using it: 


1. Install Ruby 2.0 or higher. Follow the instructions at 
http://www. seleniumframework.com/basic-tutorial/ 
setup-ruby-and-components/ if you need help. It is a good 
idea to have RubyMine IDE installed too, as you will use it in 
the subsequent chapters. 


2. Installarc gems. 


# Fresh installation 

gem uninstall -aIx appium lib ;\ 

gem uninstall -aIx appium console ;\ 

gem install --no-rdoc --no-ri appium console bond 
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For troubleshooting instructions, follow this link at 
https://github.com/appium/ruby_ console. 


If you are upgrading, here is what you should expect: 


Anyones-Mac-mini:~ pmacharl$ pwd 

/Users/pmacharl 

Anyones-Mac-mini:~ pmacharl$ mkdir arc_tests 
Anyones-Mac-mini:~ pmacharl$ cd arc_tests/ 
Anyones-Mac-mini:arc_ tests pmacharl$ arc upgrade 
gem uninstall -aIx appium lib; gem uninstall -aIx 
appium_ console; gem install --no 

-rdoc --no-ri appium console 

Upgrade complete. 


The ARC configuration file. ARC looks for an appium.txt 
file, which has key/value pairs as defined by ARC. There are 
certain key/value pairs expected for Android versus for iOS. 
Here is an example of how you can get started quickly: 


Anyones-Mac-mini:arc_ tests pmacharl$ arc version 
appium console: v1.0.4 

appium lib: v8.0.1 

Anyones-Mac-mini:arc_tests pmacharl$ arc setup android 
Anyones-Mac-mini:arc tests pmacharl$ ls 

appium.txt 

Anyones-Mac-mini:arc tests pmacharl$ cat appium.txt 
[caps] 

platformName = “android” 

deviceName = "Nexus 7" 

app = °./api.apk" 

appPackage = “io.appium.android.apis" 

appActivity = °.ApiDemos” 

[appium lib] 

Sauce username = "" 
Sauce access key = 


e The sauce username and sauce access key can be safely 
ignored until you plan to use Sauce Labs infrastructure for 
execution. 


e Access the appPackage and appActivity values for Android 
either by talking to the developer of the app or by using the 
following commands. 
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Method1 


There are two ways to look at the app. The first method executes the following code on the 
command line: 


# Returns the package's name, versionCode and so on 
aapt dump badging app-debug.apk | grep package:\ name 


# Returns all launchable activities. Generally the main entry point to app 
will be named as *.MainActivity (but that may change as per developer's 
decision) aapt dump badging app-debug.apk | grep launchable-activity 


Method2 


The package name and activity can also be read from the manifest file. You can see the 
full content of the manifest file by executing the following command. This will output the 
topology (the metadata and its hierarchy) of your app. The activity that doesn’t have any 
ParentActivity will be the MainActivity in general. The rest of the activities will have 
ParentActivity. (An activity is a single screen with the user interface.) 


aapt l -a app-debug.apk 
Note The aapt binary is located in the $ANDROID HOME/build-tools/x.y.z directory. 


For full list of appium. txt capabilities (key/value pairs), see https: //github.com/ 
appium/appium/blob/master/docs/en/writing-running-appium/caps.md. 


Note On Android, the deviceName capability is currently ignored. 


Inspecting Using ARC 


Understanding the composition of the application from the UI helps you identify the 
elements and the operations to be performed on them later. This section looks at the app 
and identifies the HTML elements. 


109 


CHAPTER 8 ™ WORKING WITH APPIUM 


Prerequisites 
Before you start, you need to do the following: 


1. Setup an AVD and name it Nexus 4 API 23. The base images 
are already available with the SDK. See Figure 8-11. 


Nexus 4 API 23 
Nexus 4 (d.7°, T68 x 1280: xhdpi 
Target: Google APIs (Google Inc.) - API Level 23 
CPUJABI: Googla AKls Iniel Alom (x86) 
Keyboard: “ Hardware keyboard present 
Skin: Skin with dynamic hardware controls 
Front Camera: None 


Back Camera: None 


Memory Options: RAM: 1636 


internal Storage: 


Size: 


e File: | /Users/pmacharl/.android/aveyNexus_4_ AP|_23.avd/sdcard img 


Emilarinm Pimba m: x| Line Hast GPL 


Cancel 





Figure 8-11. Set up AVD 


2. Notice that Use Host GPU is selected and Snapshot is not. 
These two fields are mutually exclusive. 


3. The Appium server should be running. If not, start it on the 
default 4723 port. 
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The Appium.txt File 


Using the appium.txt configuration file, type arc in the folder that contains appium. txt: 


# appium.txt 
[caps] 
platformName = “Android” 

deviceName = "Android" 

avd = "Nexus 4 API 23" 

app =" 

appPackage = “com.android.settings” 
appActivity = ".Settings" 

[appium lib] 
Sauce_username = 
Sauce access key = 


As soon you type arc in the command line, you should see it processing and AVD 
will be launched. (Patience is a virtue here and AVD's time to launch is based on your 
machine configuration.) 

In the command line, the control returns to ARC (pry), where you can now interact 
with AVD through appium_ lib-provided API calls. See Figure 8-12. 


bash 


inyones—Mac-mini:arc_android pmacharl$ arc 
[1] pry(main)= 


settings 


Wireless A notworks 


© Data usage 


Display 


Sound & notification 


storage & USB 





Figure 8-12. Appium Ruby console (ARC) 111 
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1. The full list of available commands is found at 
https: //github.com/appium/ruby_ console and is always 
evolving. 


2. page class: 


Anyones-Mac-mini:arc_android pmacharl$ arc 
[1] pry(main)> page class 

22x android.widget.LinearLayout 
10x android.widget.FrameLayout 
10x android.widget.TextView 

6x android.view. View 

6x android.widget.RelativeLayout 
6x android.widget. ImageView 

4x android.view.ViewGroup 

1x android.widget.ScrollView 

1x hierarchy 


3. Source: 


[2] pry(main)> source 

<?xml version="1.0" encoding="UTF-8" ?> 
<hierarchy rotation="0"> 
<android.widget.FrameLayout index="0" text="" 
class="android.widget.FrameLayout™ 
package="com.android.settings’ content-desc= 
checkable="false" checked="false" clickabl 
e="false" enabled="true" focusable="false™ 
focused="false" scrollable="false" 
long-clickable="false" password="false" 
selected="false" bounds="[0,0][768,1184]" 
resource-id="" instance="0"> 
<android.view.ViewGroup index="0" text="" 
class="android.view.ViewGroup" package=" 
com.android.settings’ content-desc="" 
checkable="false" checked="false" clickable="false" 


[3] pry(main)> id('android:id/decor_content_parent') 
#<Selenium: :WebDriver: : Element :0x323fca632c4ee948 id="1"> 


[4] pry(main)> id('android:id/decor_content_ 
parent').methods 


[ 

[ 0] !() Selenium: :WebDriver: : Element 
(BasicObject) 

[ 1] !=(argi) Selenium: :WebDriver: :Element 
(BasicObject) 
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[30] pry(main)> xpath('//android.widget. 
FrameLayout').get page class 

"15x android.widget.FrameLayout\n11x android.widget. 
LinearLayout\n8x android.widget. 

TextView\n6x android.view.View\n6x android.widget. 
ImageView\n1x android.widget.GridLayout 

\n1x android.widget.ScrollView\n1x android.view. 
ViewGroup\n1x android.widget.Relative 

Layout\n1x hierarchy" 


[31] pry(main)> xpath('//android.widget. 
FrameLayout').get android inspect 
"\nandroid.widget.FrameLayout (1)\n id: com.android. 
systemui:id/panel holder\n\nandroid 
.widget.FrameLayout (2)\n 


Finally, if you prefer to use the driver object (the Selenium driver) directly instead of 
using wrapped methods (like d() used previously), you can access the driver object directly. 


driver.textfields 
driver.find element(:xpath, "//android.widget.FrameLayout" ) 


The takeaway from this section is that the more practice and comfort you get with the 
APIs exposed by Appium, the easier it will be to code the same during scripting. 


Using uiautomatorviewer 


In the chapter that covers uiautomatorviewer, I introduced the tool. Now let’s see how to 
use it to look at an app. 


1. 


Type uiautomatorviewer in the command line to launch 
the program ($ANDROID_ HOME/platform-tools should be in 
$PATH). 


Click the Device Screenshot, uiautomator Dump icon. 


Select the Android target (avd/device) that 
uiautomatorviewer should take the XML screenshot from. 


For AVD, it takes a little bit more time than a real device. 
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5. After this, you can see the tree hierarchy and use the attributes 
to further identify elements during automation script writing. 
See Figure 8-13. 


©“@82@ua 





Ce ga 


Figure 8-13. Introspecting on the target device 
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In Figure 8-14, you can identify the element that displays the time in Appium using 
any of the following locator(s): 


ALE 





E å JN WA = (008.4% 


(0) TextView: For transferring phatc 
"i2 RelativeLayout [00768.50] 
(0) TextView: Android [22 0518, A0] 
+{1) LinearLayout (550,0)/694,80) 
* (2) FrameLayout (64,0) 762,80) 
* (2) GridLayout /0,249)[ 768,624) 
T(0) LinearLayout [0.249)[768,524] 
+ (0) LinearLayout (0,466)(/768,424) 
(1) TextView: A EN S (afi}1S) (200,249)/587 505) 


R Mog Detail 
SanDisk SD card indar 1 
Pow transfering photog ane madis tant 416 
resource -bd com.android.systenui:id/clock view 
casa android widget. TextView 
package bom. andróid. systemui 
content-desc 416 
checkable falsa 
checked false 
clickable false 
enabled true 
foousable false 
Charcien fprusad false 
= scrollable false 
long-Clic kable false 
password false 


Figure 8-14. Traversing the application DOM 


id('com.android.systemui:id/clock_view') 
tag('android.widget.TextView') # Observe that classname is tag in mobile app. 
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CHAPTER 9 


Test Strategy and Execution 


In the previous chapters, you learned how to build and deploy an app on an Android 
device. 

This chapter covers the details of executing automated tests (written in the 
Cucumber Gherkin framework) against a target device. This is the final step in getting the 
full feedback on changes introduced in the app. 


Note Weare talking about outside-in tests here. Inside-out, i.e. unit, tests involve 
only a developer. The goal with Cl is to get the maximum value as perceived by the end 
consumer. Hence, the tests mentioned here are integration/end-end tests. 


Continuous Test Automation with Cucumber 


You can choose any testing framework you like. As an example, I chose Cucumber (with 
Ruby), because it lets me describe the “what” piece (the features) first. Then I write the 
“how” layer (the step definitions), i.e. the technical piece, later. In my experience, I feel 
that this results in good collaboration between multiple roles. If you are a developer and 
are working in a silo, choose whatever framework fits your needs (JUnit, rspec, testing, 
et al.). The following links can help you understand the Cucumber basics: 


e Why use Cucumber at http://www. seleniumframework.com/ 
cucumber -2/make-a-case/why-cucumber/ 


e Information about ATDD, BDD, and TDD at http://www. 
seleniumframework.com/cucumber-2/make-a-case/atdd-tdd-bdd/ 


e Using continuous test automation at http://www. 
seleniumframework.com/cucumber-2/make-a-case/continuous- 
test-automation/ 


e Learn how Cucumber works at http: //www.seleniumframework. 
com/cucumber-2/make-a-case/how-cucumber-works-2/ 
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Installing Cucumber at http://www. seleniumframework.com/ 
cucumber-2/install-cucumber/ 


Learn Cucumber’s keywords at http://www. seleniumframework. 
com/cucumber-2/cucumber -keywords/ 


Step definitions at http: //www.seleniumframework.com/ 
cucumber-2/step-definitions/ 


The basic Ruby tutorial for the web at http://www. 
seleniumframework.com/introduction/what-is-ruby/ 


Iam not going to explain Cucumber and its fundamentals and will assume that you 
have a basic understanding and have visited these links. 


High-Level Mindmap 


The high-level explanation of the code you are going to see in the next few sections is as 


follows: 


1. 


> pm e 0 P 


Your Android build process puts the app-debug.apk in the 
./features/support/resources folder. 


Write the Cucumber features. 

Complete the context code (env. rb and hooks . rb). 
List your target devices in devices .yaml. 

List your target emulators in emulators .yaml. 


Define a module that returns the desired capabilities object 
(representing the device/emulator) to talk to the Appium 
server. 


The default Cucumber profile writes HTML and JSON results. 


Write tests and tag them so that appPackage and appActivity 
are defined both for the app to be tested and for the generic 
settings on the Android device. (The settings needn't be tested 
in actuality, but we have this example to get started). 


Test Framework 


The test framework used here is based on Cucumber, Ruby, and the Appium _lib gem. 
Hence, I describe the “what” in features/scenarios and the “how” in the code-behind 
(step_definitions). 

This aligns very well with ATDD (acceptance test-driven development). 
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Git Repo and Folder Structure 


The git repository used for demonstrating test automation in this book can be found at 
https://github.com/machzqcg/ci_android acceptancetests. git. 
Figure 9-1 shows the folder structure. 


O- Project - 
M c_android_acceptancetests 
v © features 
vy © step_definitions 
]D step_defs.rb 
@D steps.rb 
v (CJ support 
v resources 
li] app-debug.apk 
+ env.rd 
*] hooks.rb 
\ cl_android.feature 
vy Dib 
v Ciconfig 
devices.yam!| 
emulators.yaml 
*) capabilities.rb 
* screen_helper.rb 
> © scripts 
® contact_screen.png 
cucumber.yml 
é example.mp4 
+| Cemfile 
Gemfile .lock 
*, Rakefile 
README.md 
mem reports.json 
bj results. html 
J External Libraries 





Figure 9-1. The folder structure 


e ci android acceptancetests is the Cucumber project root. 
e The features folder contains features. 


e The step definitions folder contains the code-behind. In this 
case, it has two Ruby files. There can be any number and can be 
spread across files. 


e The support folder is the standard Cucumber support folder, i.e., 
the code in this folder is executed when the Cucumber process 
starts and the resources folder contains app-debug.apk, which is 
the output of the build process. 


e env.rb is usually the file where modules for the Cucumber project 
and any other context must be loaded. 


e hooks.rb contains the pre- and post-conditions for scenarios. You 
can put this in env. rb instead, but by convention, I use hooks. 
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e ci _android.feature contains the scenarios or tests. 


e The lib folder is defined by this framework to store the code that 
is mixed in. It also contains configuration definitions for devices 
and emulators. 


e devices.yaml contains device definitions. 
e emulators.yaml contains emulator definitions. 


e capabilities.rb contains the module that returns the desired 
capabilities object. 


e Thescreen helper.rb module is for future use to apply page 
object patterns. 


e The scripts folder is to quickly test something before you 
formalize it in features. It’s not necessary, but it’s helpful for 
writing quick snippets of code. 


e contact_screen.png was a screenshot taken by one of the 
scenarios. 


e cucumber. yml is the configuration file for Cucumber. 


e example.mp4 is the screen capture taken when executing the 
scenario. (See the adb tutorial section on how to take a screen 
recording). 


e Gemfile contains the gems used in this project. 
e Gemfile.lock is created when you run bundle install. 


e Rakefile is not used at this point, although you can define 
higher-level tasks. 


e README.md contains the readme file for this project. 
e reports.jsonis the JSON-formatted output of Cucumber. 


e reports.html is the HTML-formatted output of Cucumber. 


Writing the Tests 


This section shows you how to write a couple of Cucumber scenarios. Since it is simple 
English, the scenarios don't need extra explanation. 
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Cucumber Scenarios (ci_android.feature) 


First consider the Cucumber scenario (see Figure 9-2). 


B- Project + (9 = | - 


v (J ci_android_acceptancetests (~/c\_an 


v features 
v ()step_definitions 
@step_defs.rb 
È steps.rb 
v O support 
v O resources 
li] app-debug.apk 
iv env.rb 
F] hooks.rb 
__) ci_android. feature 
vy lib 
Y Fi config 
devices.yaml 
emulators.yaml 
"| capabilities.rb 
e] screen_helper.rb 
>» Ö scripts 
[a comact_Screen.png 





(J ci_android.feature x 


Feature: CI Android 


ALL screens should Launch fine 
@non-ci 
Scenario: Settings 
Given I click about phone 
Then the Android version is a number 
@ci_smoke 
Scenario: Open ci app and navigate to login screen 
Given I open login screen on app 
And I click add contact 
Then I verify contact screen is displayed 
@ci_add_contact 
Scenario: Add contact 
Given I open login screen on app 
And I click add contact 
Then I successfully add a contact 
And verify that it was added 
@ci_ smoke 
Scenario: Take screenshots 
Given I open login screen on app 
And I click add contact 
Then take screenshot of contact form 


Figure 9-2. Feature file location in the folder structure 


Feature: CI Android 


All screens should launch fine 


@non-ci 
Scenario: Settings 


Given I click about phone 


Then the Android version is a number 


@ci_smoke 


Scenario: Open ci app and navigate to login screen 
Given I open login screen on app 


And I click add contact 


Then I verify contact screen is displayed 


@ci_add contact 
Scenario: Add contact 


Given I open login screen on app 


And I click add contact 


Then I successfully add a contact 


And verify that it was added 


@ci_smoke 


Scenario: Take screenshots 


Given I open login screen on app 


And I click add contact 


Then take screenshot of contact form 
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hooks.rb 


The values for appActivity and appPackage were retrieved using the aapt command, as 
described in Chapter 8. 


require ‘./lib/capabilities' 

include DesiredCapabilities 

Before('@ci_smoke') do 

caps = local capabilities(app='app-debug.apk' ,appActivity='com.example. 
android.conta 

ctmanager.ContactManager' , 
appPackage='com.example.android.contactmanager' ) 
@driver = Appium: :Driver.new(caps) 
Appium.promote_appium methods AppiumWorld 

puts “Execute anything before scenario/test case" 
@driver.start_driver 

end 

Before('@ci_add contact’) do 

caps = local capabilities(app='app-debug.apk' ,appActivity='com.example. 
android.conta 

ctmanager.ContactManager' , 
appPackage='com.example.android.contactmanager' ) 
@driver= Appium: :Driver.new(caps) 
Appium.promote_appium methods AppiumWorld 

puts “Execute anything before scenario/test case" 
@driver.start_driver 

end 

Before('@non-ci') do 

caps = local capabilities(app='' ,appActivity='.Settings' ,appPackage='com. 
android.set 

tings’ ) 

@driver = Appium: :Driver.new(caps) 
Appium.promote_appium methods AppiumWorld 

puts “Execute anything before scenario/test case" 
@driver.start_driver 

end 

After do |scenario| 

if scenario. failed? 
@driver.screenshot("#{scenario.name} failed.png") 
end 

@driver.driver quit 

puts “Execute anything after scenario/test case" 
end 
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env.rb 


As you Can see, you create a custom World class, which is used in hooks. rb. 


require ‘rspec/expectations' 

require ‘appium lib' 

require ‘cucumber/ast' 

require ‘yaml' 

require ‘active support/core ext/hash' 

# Create a custom World class so we don't pollute “Object™ with Appium 
methods 

class AppiumWorld 

end 

World do 

AppiumWorld.new 

end 

$devices = YAML.load(File.open('./lib/config/devices.yaml' ) ) 
$emulators = YAML.load(File.open('./lib/config/emulators.yaml' )) 


Devices Lab 


My device lab is shown in Figure 9-3. At this point, there are only three devices; however, 
you can connect many more by purchasing an USB extension cord. 





Figure 9-3. Mini device lab 


123 


CHAPTER 9 ™ TEST STRATEGY AND EXECUTION 


You need to start the Appium server(s) on the available network ports to talk to each 
of these devices. For this example, I execute on only one device. 


devices.yaml 


You define the devices configuration in a YAML file, as shown in the following code. If you 
have a new device to be connected, copy and paste the block and then replace the values 
(serial, name, and port) as needed. 

Ensure that you provide a different port for each device. 


Note This port should be the same value that the Appium server starts on (the default 
Appium server port is 4723). 


devices: 
huawei-nexus_6p-84B5T15A17000142: 
Caps: 

platformName : Android 

deviceName : huawei-nexus_6p-84B51T15A17000142 
app: app-debug.apk 

appActivity : .Settings 
appPackage : com.android.settings 
appium lib: 

Sauce_username: 

Sauce access key: 


port: 4768 
motorola-google-ZX1B222FCD: 
Caps: 


platformName : Android 

deviceName : motorola-google-ZX1B222FCD 
app: app-debug.apk 

appActivity : .Settings 

appPackage : com.android.settings 
appium lib: 

Sauce_username: 

Sauce access key: 

port: 4778 
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emulators.yaml 


Similar to the devices, you must also define the emulators’ configuration. You should 
have already defined the AVDs by this time. See the AVD Manager to learn how to add 
AVDs. 


emulators: 
Nexus_5 API 23 x86: 
Caps: 

platformName : Android 
deviceName : IGNORED 

avd : Nexus 5 API 23 x86 
app: app-debug.apk 
appActivity : .Settings 
appPackage : com.android.settings 
appium lib: 
Sauce_username: 

Sauce access key: 
Nexus _4 API 23 x86: 
Caps: 

platformName : Android 
deviceName : IGNORED 
avd: Nexus 4 API 23 

app: app.debug.apk 
appActivity : .Settings 
appPackage : com.android.settings 
appium lib: 
Sauce_username: 

Sauce access key: 


Capabilities.rb 


This file returns the desired capabilities object and is mixed in hooks. rb: 


module DesiredCapabilities 

def local _capabilities(app={},appActivity={}, appPackage={}) 
if ENV[ 'DEVICE'].nil? and ENV[ ‘EMULATOR’ ].nil? 

puts “One of the targets DEVICE or EMULATOR has to be set" 
puts "Allowed devices: #{$devices|'devices' |.keys}" 

puts "Allowed emulators: #{$emulators[ ‘emulators’ ].keys}" 
exit 

end 

if ENV['DEVICE'].nil? || ENV['DEVICE'].empty? 

puts “Did not specify device target. Assuming emulator is set" 
caps = $emulators[ ‘emulators’ |["#{ENV[ ‘EMULATOR’ ]}"] 

if app.nil? || app.empty? 

caps['caps'] = caps['caps'].except( ‘app’ ) 


125 


CHAPTER 9 ™ TEST STRATEGY AND EXECUTION 


else 

caps['caps']['app'] = File.join(Dir.pwd,"features/support/resources", app) 
end 

caps['caps']['appActivity'] = appActivity 

caps['caps']['appPackage'] = appPackage 

end 

if ENV['EMULATOR'].nil? || ENV[' EMULATOR’ ].empty? 

puts “Did not specify emulator target. Assuming device is set" 

caps = $devices[ 'devices' ]["#{ENV[ ‘DEVICE’ ]}"] 

if app.nil? || app.empty? 

caps['caps'] = caps['caps'].except( ‘app’ ) 

else 

caps['caps']['app'] = File.join(Dir.pwd,"features/support/resources", app) 
end 

caps['caps']['appActivity'] = appActivity 

caps['caps']['appPackage'] = appPackage 

end 

caps 

end 

end 


ScreenHelper.rb (Not Used) 


Page object framework enthusiasts can use this module to define page objects using 
page-factory. 


module ScreenHelper 

def visit(page class, &block) 

on page class, true, &block 

end 

def on(page class, visit=false, &block) 

page class = class from string(page class) if page class.is a? String 
page = page class.new @browser, visit 

block.call page if block 

page 

end 

def wait for _ajax(timeout = 10) 

timeout.times do 

return true if browser.execute script('return jQuery.active').to i == 0 
sleep(1) 

end 

raise Watir::Wait::TimeoutError, "Timeout of #{timeout} seconds exceeded on 
wait 

ing for Ajax." 

end 

private 

def class from string(str) 
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str.split('::').inject(Object) do |mod, class name| 
mod.const_get(class_ name) 

end 

end 

end 


Step Definitions 


Here are the step definitions: 


Given /*I click about phone$/ do 
scroll to( ‘About phone').click 


end 
Given /*‘the Android version is a number$/ do 
android version = ‘Android version’ 


scroll to android version 

view = ‘android.widget.TextView' 

version = xpath(%0(//#{view}|preceding-sibling: :#{view}[@text="#{android_ 
version}" |] 


)). text 

if !version.match(/\w/).nil? || !version.match(/\d/).nil? 
puts "Version: #{version} pass" 

else 


puts "Version: #{version} is NOT a word or number" 
# valid = !version.match(/\d/).nil? 

end 

# expect(valid).to eq(true) 

end 


Now step _defs.rb: 


Given(/^I open login screen on app$/) do 

add_contact = id('com.example.android.contactmanager: id/addContactButton’ ) 
exists(post_check=30) { add contact.text == ‘Add Contact’ } ? puts('Add 
Contact exists') : puts('App failed to open') 

end 

And(/^I click add contact$/) do 

id('com.example.android.contactmanager: id/addContactButton' ).click 

end 

Then(/*I verify contact screen is displayed$/) do 
expect(id('android:id/text1').text).to eql("seleniumfrmwrkguest@gmail.com" ) 
end 

Then(/*I successfully add a contact$/) do 
id('com.example.android.contactmanager: id/contactNameEditText').type "blah" 
id('com.example.android.contactmanager: id/contactPhoneEditText').type "123- 
456-7890" 
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id('com.example. android. contactmanager: id/contactPhoneTypeSpinner' ).click 
tags('android.widget .CheckedTextView' )[2].click 

id('com.example. android. contactmanager:id/contactEmailEditText').type 
“pradeep@seleniumframework. com” 

id('com.example. android. contactmanager: id/contactSaveButton' ).click 

end 

And(/‘verify that it was added$/) do 

expect (id('com.example.android.contactmanager: id/contactEntryText').text). 
to eql('blah' ) 

end 

Then(/“*take screenshot of contact form$/) do 
@driver.screenshot("contact_screen.png") 

end 


Explanation of Key Concepts 
This section explains the key concepts. 


e The locators are retrieved through uiautomator or arc or by 
printing the source. See the section entitled “Introspecting App” 
to learn about retrieving locators. 


e Inthe step definitions, you must identify the elements, then 
retrieve the text and assert it against the expected text. 


e You also need to perform actions like clicking and setting text 
by filling in the contact form and verifying that the contact was 
saved, 


e Itis also possible to take a screenshot at any point by calling the 
method on the driver object. 


Executing the Test from the Local Lab 


Now that you have written your tests, you can execute them. These examples assume that 
you connected your devices through USB or WiFi. 
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Start the Appium Server 
To start the Appium server, follow these steps: 


1. Identify the device using adb devices. (You should have 
connected the device either through USB or WiFi). 


2. Start the Appium server on the port (the same port that was 
defined for the device in the devices. yaml file) and specify 
the bootstrap port (must be at least 10 ports apart). 


Anyones-Mac-mini:~ pmacharl$ adb devices 

List of devices attached 

ZX1B222FCD device 

Anyones-Mac-mini:~ pmacharl$ appium -p 4778 -bp 4789 -U ZX1B222FCD 

info: Welcome to Appium v1.4.11 (REV 
8cf8311f00e59a2b10Fde1834fcf6d5ace6fbcdo) 

info: Appium REST http interface listener started on 0.0.0.0:4778 

info: [debug] Non-default server args: {"udid":"ZX1B222FCD", "port":4778, 
"bootstrapPort":4789} 

info: Console LogLevel: debug 


Execute the Test 


The DEVICE or EMULATOR parameters are mandatory since a target is required to run the 
test. If none is specified, a validation error is raised. The permissible values are the keys 
inside the devices. yaml/emulators.yaml file. 


e Example 1: DEVICE=motorola-google-ZX1B222FCD 
e Example 2: EMULATOR=Nexus 4 API 23 x86 


Execute settings scenario on a device: 


bundle exec cucumber features/ci_ android. feature:5 DEVICE=motorola-google- 
ZX1B222FCD 


Execute open login screen: 


bundle exec cucumber features/ci_ android. feature:9 DEVICE=motorola-google- 
ZX1B222FCD 


Add contact scenario: 


bundle exec cucumber features/ci_ android. feature:15 DEVICE=motorola-google- 
ZX1B222FCD 
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Take screenshot scenario: 


bundle exec cucumber features/ci_android.feature:21 DEVICE=motorola-google- 
ZX1B222FCD 


Figure 9-4 shows the execution alongside the code. 


1 i 
1 steps {i resedi 
Geri. J759 
Anypones-Aac-M inci _androLo_scceaptancetests peacharls padle exec cucumber features/ci_andradd, feature: 13 PEYICE=myterngi 
Using the default profile... 
Feature! CI Android 

ALL scrtens shauld Launch fine 


erarie {1 patries) 


1 stengria {1 paisai) 

À etepe {4 parraad) 

Šat. i hi 

Anypones-Sac-aind:ci_andreid_acceptancetests peocharld Gaede exec cucuaber featurcerci_ondradd. features 21 MYICi=astero i 


Using the defawht pretale.as 
Festure: CI Andreid 
All screens shewld Lewnch fine 
oO: ae af Peenihal. 
= £ a 3 
i 
' 





J ct paire 
tare. 730s OMLINE SaaS 76 2.0 Mb) 432 ma (4.6 Mb/s) 


Figure 9-4. Execution alongside code 


To see a full video of the execution, visit https: //www. youtube. com/ 
watch?v=In9sCFrv-Do&feature=youtu. be. 

The device screen is exported and you can see the server and target execution in 
one screen. That is one of the challenges in demonstrating the automation value on the 
mobile side. For the web, since the browser launches on the machine itself, it is relatively 
easier. 


Executing the Test from Sauce Labs 


As you continue executing tests and attempt to increase the coverage on various devices, 
form factors become a critical issue. Sure, you can keep buying devices; however, there 
is not much economy of scale in doing so. Wouldn't it be nice to have that non-core 
competency of maintaining the devices offloaded to a service provider? 

Sure enough, there are many providers out there that do just that, including Sauce 
Labs, Perfecto Mobile, and ExperiTest. This chapter provides an example of Sauce Labs, 
because they are aligned with Appium. 
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What Is Sauce Labs? 


Sauce Labs provides both infrastructure and platform cloud services. 


e Infrastructure: Over 700 combinations of browsers and OS 
platforms. Includes mobile emulators and simulators, as well as 
real devices. 


e Platform: Selenium Grid platform, so that automation tests 
that talk in the WebDriver protocol can execute tests against the 
underlying infrastructure. 


e User Interface: A nice GUI for manual testing and on-demand 
availability of browsers, emulators, simulators, and real mobile 
devices. Sauce Labs’ features cannot be summed up here, but I 
encourage you to read more about it online. 


Running Against Sauce Labs 


You can run Sauce Labs on real devices or emulators. 


Running on Real Devices 


Upload your app to the Sauce storage. Replace the values with your Sauce credentials: 

$ curl -u $SAUCE USERNAME:$SAUCE ACCESS KEY -X POST “http://saucelabs.com/ 
rest/v1/stor age/$SAUCE USERNAME/my_app.zip?overwrite=true’ -H “Content- 
Type: application/octet-str eam" -data-binary @my_app.zip 


Now add the real device configuration in devices. yaml. An example is shown in 
Figure 9-5. 
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Pio 


pt | Hee fe || devices.yam! x 
gitprojects/ci_a déevicenane : Motorola-goog Le-ZA1B222ZFLD 
app: app—debug.apk 
appActivity : Settings 
appPackage : com. android. settings 
appium_Lib: 


sauce_username: 
sauce_access_key: 
saucelabs_samsung_galaxy_s5: 
Caps: 
platformName : Android 
platformVersion : '4.4' 
deviceName : ‘Samsung Galaxy 55 Device’ 
app: http://saucelabs.com/example_files/app—debug. apk 
appActivity : ,ContactManager 
appPackage : cóm. example. android. contactmanager 
appium-version : "1.4.16" 
appium_lib: 
sauce_username: <replace_with_username> 
sauce_access_key: 0956c4a2-f696-4f fb-a4b0-abl14f54a3e59 
saucelabs_samsung_galaxy_s4: 
caps: 
platformName : Android 
platformVersion : '4.4' 
deviceName : ‘Samsung Galaxy 54 Device’ 
app: http: //saucelabs.com/example_files/app-debug. apk 
appActivity : .ContactManager 
appPackage : com. example. android. contactmanager 
appium—-version : "1.4.16" 
appium_lib: 
sauce_username: <replace_with_username> 
sauce_access_key: 8956c4a2-f696-4f fb-a4b@-abl4f54a3e59 





Figure 9-5. Sauce Labs configuration in devices.yaml 


Feature Files (ci_android.feature) 


Here is the feature file: 


@ci_add contact sauce 

Scenario: Contact on sauce 
Given I open login screen on app 
And I click add contact 
Then I successfully add a contact 
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Hooks.rb File 


Here is the Hooks . rb file: 
Before('@ci_add contact _sauce') do 


caps = sauce capabilities(app='http://saucelabs.com/example files/app- 
debug.apk’ , app 
Activity='com.example.android.contactmanager.ContactManager' , 
appPackage='com.example.android.contactmanager' ) 


@driver= Appium: :Driver.new(caps) 
Appium.promote_appium methods AppiumWorld 
puts “Execute anything before scenario/test case" 
@driver.start_driver 

end 


Execute the File 


Now run it: 


bundle exec cucumber features/ci_android.feature:26 DEVICE=saucelabs 
Samsung galaxy s4 


Feedback 


Once you kick off the execution, you should instantly see a row on the Sauce dashboard 
that represents the execution session. See Figure 9-6. 
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Figure 9-6. The Sauce Labs console 
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When the execution is complete, the results should look like Figure 9-7. 
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Figure 9-7. Sauce Labs execution results 


Clicking the execution session row, you can find information that will help you 
analyze the results (including videos, Appium logs, screenshots, and detailed logs). 
Figure 9-8 shows the Sauce Labs execution video. 


Upgrade Resources Docs Platforms 





Commands 








Figure 9-8. Sauce Labs execution video 
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The results can also be found in the results.html file in the root folder 
(see Figure 9-9), since the example outputs the HTML results as specified in the 
cucumber. yaml configuration file. 
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Figure 9-9. Cucumber results 


Running on Emulators 


Since Sauce Labs provides emulators, the difference is the way you construct the desired 
capabilities object, and therefore replace the values in emulators .yaml. The values can 
be read from their documentation, found at https ://wiki.saucelabs .com/display/ 
DOCS/Platform+Configurator#/. 


Parallel Devices Automation 


This section contains a brief description on how to execute tests in parallel across devices. 
Executing automated tests in parallel is dependent on any of the following 
(see Figure 9-10): 


e App support of parallel sessions 
e Whether the test automation framework can initiate parallel tests 


e Whether there are multiple Appium servers, one for each device, 
with dedicated ports 
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Figure 9-10. Parallel devices execution architecture 


Parallel execution also might result in race conditions, so understanding the 
application domain and call path is extremely important before you can certify 
parallel tests. 


Start Appium Servers on Different Ports 


Here is the command to start multiple Appium servers. Be sure to open a new shell for 
each of these Appium servers. 


appium -p 4724 -bp 4726 -U EGxxxxxxxxx 
appium -p 4734 -bp 4736 -U EGxXxxxxxxxx 


If your target device/emulator has an SDK less than 4.2 or an API level less than 16, 
Appium uses selendroid. In that case, you have to append --selendroid-port to the 


previous command (generally stay 10 ports apart, because Appium uses +1 port of -p): 


appium -p 4724 -bp 4726 --selendroid-port 4737 -U EGxxxxxxxxx 
appium -p 4734 -bp 4736 --selendroid-port 4747 -U EGxxxxxxxxx 


If you are running Appium from the Appium. exe path, then use: 


node appium --nodeconfig path\to\nodeconfig.json -p 4724 -bp 5724 
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Or if you’re using cmd, use this command: 


appium --nodeconfig path\to\nodeconfig1.json -p 4724 -bp 5724 


Client Side 


This refers to the test automation framework code that can connect to the Appium servers. 
You must write logic to instantiate the driver session based on the available pool of 
devices/emulators. In this case, you have to parse the devices. yaml or emulators. yaml 
file and create a $driver session by connecting to the corresponding port. 
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